budapi资料中文说明

buddyapi资料[转帖]
我在找buddyapi的使用说明，找到这些，不错，大家一起分享！

--------------------------------------------------------------------------------
目录：
一、安装
二、装载Buddy函数
三、发布你的应用程序
四、新版本的特征(针对3.4)
五、信息函数（Information functions）
六、系统函数（System functions）
七、文件函数（File functions）
八、窗口函数（Window Functions）
九、注册信息函数


从今天开始我将为大家陆续介绍一些Xtra的详细用法，包括翻译一些文章和列举一些实例，如果大家有兴趣的话可以一起探讨(stiffdavid@)。我主要介绍的内容包括：
Buddy API 译文及实例
Directmedia 译文及实例
FileIO 译文及实例
XtrAgent 译文及实例
部分XDK开发文章的翻译

标题：BuddyAPI 第一部分(译文)
译者：杨英华
日期：2001-08-18 14:32

以下我们对BudAPI这个Xtra进行讲述，主要针对Windows部分和Director部分进行翻译，因而Macintosh和uthorware部分将被省略，本文中Buddy API版本为3.4。受奥古启发，回去后加以研究，发现这个Xtra功能非常多，简直就可以说是一个API集合。


一、安装
Windows版本的Buddy API包含以下3个文件：
BudAPI.x32 32bit Xtra
BudAPI.u32 32bit u32
BudAPI.hlp 电子帮助文档
这个版本的xtra支持Director 5,6,7和8，我现在使用的是Director 8.5版本，使用过程中没有出现问题。把以上3个文件放入Director的Xtra目录下即可。重新启动Director，你在Xtra菜单下可以找到Buddy API Help这个菜单项，执行他将打开帮助文件。

返回顶部

二、装载Buddy函数
安装完Xtra后，Buddy API所有的函数就可以马上使用了。所有的函数都是全局函数(Global Functions)，即不需要先对他进行声明，不需使用openXlib或者new命令，你只要在s cript窗口里输入他提供的函数即可对其进行调用，当然，你也可以在Message窗口里对其函数进行测试。例如你可以直接在Message窗口里执行“put baVersion(‘‘os‘‘)”（得到*作系统类型）

返回顶部

三、发布你的应用程序
早期的Buddy API在发布时需要两个文件：一个Xtra文件和一个DLL文件，但这个版本不再需要DLL文件。针对你的
Project我们有两种方法来发布你的Xtra。你可以把这个Xtra直接就放在你的Xtras目录下，这是我们强烈推荐的方法，特

别是你的程序要运行在比较慢的媒质(例如 CD-ROM)上时，这种方法会提供最快的加载速度，因为他不需要在每次程序运行时都被解压。
在Director的后续版本中，你可以将Xtra直接打包进Project中，但这在Director6和6.5版本中不允许，在7和8版本中却更为可靠。为了在你的Project中加入这个Xtra，你需要进行以下手工*作：选择Modify－Movie－Xtra菜单，在出现的对话框中单击Add按钮，选择budapi.x32即可。
注意在7和8版本中，要确信Include in project选项被选中。

返回顶部

四、新版本的特征(针对3.4)
停止了对16bit版本的开发（我们以后拿到的将都是32bit版本的xtra）
发布时可以删除.dll文件而仅仅只发布Xtra文件
baVersion支持Windows 2000
当使用baGetFilename来选择多个文件时，返回的字符数原先最多允许500个字符，现在增加到12000个字符。

返回顶部

五、信息函数（Information functions）
Version 返回版本信息（Windows，NT，DOS，QuickTime，VFW）
SysFolder 返回系统文件夹的位置（Windows，System，temp等等）
CpuInfo 得到处理器信息（类型、速度）
DiskInfo 得到一个磁盘信息（类型、大小、名称、数量）
DiskList 得到已经安装的磁盘的列表
FindApp 查找与指定文件类型相关联的应用程序（例如通过.doc找到Word）
ReadIni 读取Windows的ini文件
WriteIni 写入Windows的ini文件
FlushIni 强制Windows在磁盘里生成一个ini文件
ReadRegString 读取注册表的字符串类型数据
WriteRegString 往注册表里写入字符串类型数据
ReadRegNumber 在注册表中读取number类型的数据
WriteRegNumber 在注册表中写入number类型的数据
DeleteReg 删除一个注册项
SoundCard 检查是否安装过声卡
FontInsatlled 检查字体是否已经安装
CommandArgs 返回启动的应用程序的命令行参数
Previous 检查是否有前一例程在运行，即程序是否已经在运行了
ScreenInfo 得到显示器信息（分辨率等）
MemoryInfo 得到系统内存信息（总共可用物理内存、swap文件信息等）
Gestalt 返回一个完形值（原文：returns a gestalt value）
GestaltExists 检察一个完形是否存在（原文：checks whether a gestalt exists）
以上介绍了BudAPI这个Xtra的信息函数，他还包括系统函数、文件函数、Windows函数和注册表函数，下面分别应用列出，在以后的部分中将分别列举实际例子进行翻译。

返回顶部

六、系统函数（System functions）
DisableDiskErrors 禁止“Drive not ready”错误信息（即禁止“设备尚未准备好”）
DisableKeys 禁止/允许键按下
DisableMouse 禁止/允许鼠标按下
DisableSwitching 禁止/允许任务切换
DisableScreenSaver 禁止/允许屏幕保护程序
ScreenSaverTime 设置屏幕保护程序运行时间
SetScreenSaver 设置屏幕保护程序
SetWallpaper 设置桌面墙纸
SetPattern 设置桌面墙纸显示方式（平铺、居中等）
SetDisplay 设置屏幕尺寸和色深
ExitWindows 退出或者重新启动Windows
RunProgram 运行一个外部程序，可以带参数（即运行时是最小化、最大化、隐藏等）
WinHelp 显示一个Windows帮助文件
Sleep 暂停对Director/Authorware程序的调用
MsgBox 显示一个标准的Windows消息对话框
HideTaskBar 显示/隐藏Windows的任务栏
SetCurrentDir 改变DOS的当前目录
CopyText 复制文本到剪贴板
PasteText 从剪贴板粘贴文本
EncryptText 加密一个字符串
DecryptText 解密字符串
PlaceCursor 定位光标
RestrictCursor 限制鼠标在指定的屏幕区域内移动
FreeCursor 允许鼠标在任意位置移动，即取消对他的限制
SetVolume 设置wave、midi和cd的音量
GetVolume 得到音量值
InstallFont 安装TrueType或Bitmap字体
KeyIsDown 检察是否有一个键被按下
KeyBeenPressed 检查一个键是否曾经被按下过
EjectDisk 卸载和弹出一个磁盘
CreatePMGroup 创建程序管理器或者开始菜单程序组
DeletePMGroup 删除程序管理器或者开始菜单程序组
PMGroupList 返回程序管理器或者开始菜单程序组列表
PMSubGroupList 返回开始菜单程序组下的资程序组列表
CreatePMIcon 创建程序管理其或者开始菜单程序组图标
DeletePMIcon 删除程序管理其或者开始菜单程序组图标
PMIconList 返回程序管理器或者开始菜单程序组的图标列表
SystemTime 返回当前系统时间/日期
SetSystemTime 设置系统时间/日期
PrinterInfo 返回已经安装的打印机的信息
SetPrinter 改变默认打印机的设置
RefreshDesktop 刷新桌面图标

返回顶部

七、文件函数（File functions）
FileAge 返回文件存在的时间
FileExists 检查文件是否存在
FolderExists 检查目录是否存在
CreateFolder 创建一个新目录
DeleteFolder 删除一个空目录
RenameFile 重命名文件
DeleteFile 删除一个文件
DeleteXFiles 通过通配符删除多个文件
XDelete 通过通配符删除多个文件，包括子目录下的文件
FileDate 以指定形式返回文件日期
FileSize 返回文件大小
F

ileAttributes 返回文件属性
SetFileAttributes 设置文件属性
RecycleFile 把文件放到Windows95/NT的回收站中
CopyFile 复制文件
CopyXFiles 通过通配符复制多个文件
XCopy 通过通配符复制多个文件，包括其下的子文件夹
FileVersion 返回文件版本
FileList 返回一个文件夹下的文件列表
FolderList 返回一个目录下的目录列表
GetFileName 显示一个文件选择对话框
GetFolder 显示一个目录选择对话框
FindFirstFile 查找第一个符合条件的文件
FindNextFile 查找第二个符合条件的文件
FindClose 结束由baFindFirstFile开始的查找
EncryptFile 加密/解密一个文件
FindDrive 搜索所有驱动器以查找指定文件
Shell 打开文件或执行程序
OpenFile 通过与之关联的程序打开该文件（与Shell的差别请看实例部分）
OpenURL 通过缺省浏览器打开URL
PrintFile 通过与之关联的程序来打印该文件（例如运行Word来打印一个doc文件）
ShortFileName 返回Windows95的长文件名在DOS下显示的短文件名
TempFileName 返回一个临时文件的名字（确信其不再存在）
MakeShortcut 创建一个快捷方式/别名
MakeShortcutEx 创建一个Win95/NT快捷方式（是对MakeShortcut的扩展）
ResolveShortcut 返回快捷方式所指向的文件
FileType 返回文件类型
FileCreator 返回文件创建器（即与之关联的程序名称）
SetFileInfo 设置文件类型和与之关联的程序

返回顶部

八、窗口函数（Window Functions）
（译者注：这里不是Windows函数，窗口函数是针对某一个程序窗口的，而Windows函数则是针对Windows*作系统本身的）
WindowInfo 返回Windows的信息（状态、大小、位置、标题和类等）
FindWindow 通过给出的标题或者类名称查找一个窗口
WindowList 返回指定标题或者类名称的所有窗口的列表（例如打开的多个记事本）
ChildWindowList 返回某个窗口的子窗口列表
ActiveWindow 返回当前活动窗口的句柄
CloseWindow 关闭一个窗口
CloseApp 关闭一个应用程序
SetWindowSate 最小化、最大化或者隐藏一个窗口
ActivateWindow 激活指定窗口
SetWindowTitle 设置窗口的标题名称
MoveWindow 移动窗口或改变其大小
WindowToFront 把一个窗口移至最前端
WindowToBack 把一个窗口移至其他窗口后面
WindowDepth 得到一个窗口的z坐标值深度
SetWindowDepth 设置一个窗口的z坐标值深度
WaitForWindow 等待，直到指定窗口达到指定状态下
WaitTillActive 等待，直到指定窗口被激活
NextActiveWindow 返回下一个被激活的窗口的句柄
WindowExists 检查一个窗口句柄是否有效
GetWindow gets a window that is related to anoth

er window
SendKeys 向活动窗口发送键盘指令
SendMsg 向窗口发送一个Windows消息
AddSysItems 添加系统菜单项，标题栏上的按钮等
RemoveSysItems 如上所述，不过是删除
WinHandle 返回Director的主窗口名称
StageHandle 返回Director的Stage窗口

返回顶部

九、注册信息函数
About 显示有关Buddy API的信息
Register 注册Buddy API
SaveRegistration 保存你的注册信息
GetRegistration 得到注册信息
Functions 返回注册后所能使用的函数的数量

返回顶部

译者注：
如果您要使用以上函数，只要再在前面加上“ba”两个字母就可以了，Buddy APi的所有函数都是以字母“ba”开头的。例如对CpuInfo函数的引用就是“put baCpuInfo(‘‘speed‘‘)”这将得到你是CPU的速度。

返回顶部


--------------------------------------------------------------------------------