Buddy API函数[来自网洛]

信息函数（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 返回文件大小
FileAttributes 返回文件属性
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 another window
SendKeys 向活动窗口发送键盘指令
SendMsg 向窗口发送一个Windows消息
AddSysItems 添加系统菜单项，标题栏上的按钮等
RemoveSysItems 如上所述，不过是删除
WinHandle 返回Director的主窗口名称
StageHandle 返回Director的Stage窗口

注册信息函数
--------------------------------------

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

[Rock Studio 魔岩工作室 2002.8.6.]
国外Alex Hogan 编写了一个播放DVD的控件（For Authorware）awDVD.ocx
awDVD.ocx 允许在Authorware 中播放/控制DVD电影、插入交互式的多媒体内容、各种视频和音频等操作。（该控件正确使用需要DVD解码器）遗憾的是我的机器上仍然为CDROM，没有DVD可以测试！

控件属性：
awDVDFullScreen
awDVDHeight
awDVDLeft
awDVDTop
awDVDWidth

控件方法：
awDVDFastForward
awDVDGetNumberofChapters
awDVDGetVideoSize
awDVDNextChapter
awDVDPause
awDVDPlay
awDVDPlayatTime
awDVDPlayatTimeinTitle
awDVDPlayChapterinTitle
awDVDPlayTitle
awDVDPrevChapter
awDVDRewind
awDVDStop


范例下载（包括awDVD.ocx）
 awDVD768KB

A3DIR40.XMO外部函数介绍 （曾安德　编著）

LingoError

string := LingoError(errorcode)

侦测所指定的 Lingo 指令的错讯讯息为何　

例如所送的 Lingo 指令为　play frame "scene1"

如果所呼叫的 Director 影片中　没有 scene1 的 marker　会发生错误　传回的讯息应为　

"Frame not defined"

表示在这个影片中　并没有这个marker　

LingoResult

return string := LingoResult(IconID@"Icon Title")

Lingo 指令没有任何的错误时　本函数的值为执行後的结果　传回的值为一个字串　

LingoShowErrors

LingoShowErrors(showerrors)

所送的 Lingo 指令有错误时　可以选择是否以对话方块显示的方式警告之　若将 showerrors 替代为 TRUE　当 Lingo 有错误时　会显示一个对话方块警告使用者这个指令有错误　若将 showerrors 替代为 FALSE　则在任何情形之下　都不会显示警告的对话方块　

LingoTell

errorcode := LingoTell(IconID@"Icon Title", Script)

传送 Lingo 指令的函数　

Icon Title 表示所要送达的影片图示　就是 Director 影片的图示名称　Script 表示 Lingo 指令　所以　

LingoTell(IconID@"Dir Movie", "play frame 1")

表示送一个播映第一个镜头的指令给 Dir Movie 这个数位影片图示　

LingoTell(IconID@"Dir Movie", "pause")

表示让 Dir Movie 这个数位影片暂停播映的动作　

SCRLEDIT.UCD外部函数介绍 （曾安德　编著 ）
ScrollEdit
text := ScrollEdit(type, title, location, terminators, changedVar, fontName, fontSize)


显示含有卷轴的文字方块　引数的内容如下所示　

type 有二个用法　"M" 表示视窗的模式　"R" 表示只供读取而已

title 视窗的名称　

location 视窗的上　下　左　右座标　

terminators 结束视窗的方式　这个引数的值为一个ASCII 的值　

changedVar 这个值为一个字串的形式表现　它的内容为　terminator 的字元值　

fontName 字型　

fontSize 字型大小　
著

MidiLoop 函数原版说明（Rock Studio整理）

About MidiLoop

MidiLoop is a User Code Document (UCD) for Macromedia Authorware that does one simple thing: looping Midi files.By using MidiLoop, you can simply implement background music in your Authorware piece with only one function call (see: Functions).
Ive written this UCD because the MidiPlay and MidiPlaying functions from a3wmme.ucd/u32 (located on the Authorware CD) dont seem to work together. Other options (such as playing a QuickTime movie with Midi outside the presentation window) didnt work for me.
I have tested this code with Windows 95 and Windows 3.x.
Current MidiLoop version: 1.1 (April 9th 1997)

Please send comments, suggestions and/or bug reports to:
Stefan van As
Davilex Software
stefan@davilex.nl


Functions（功能函数）

Result:=LoopMidi(File)
Loops the specified MIDI file.
Example: LoopMidi("c:\\midi\\metal.mid")
Returns 0 if successful, returns 99 if device is not capable to play MIDI or if MIDI file does not exists, otherwise a MCI error value.

Result:=StopMidi()
Stops playing the current MIDI file.
Returns 0 if successful, otherwise a MCI error value.

Distribution

MidiLoop is free, unsupported software for non-commerical purposes.You are allowed to freely distribute this software along your friends. If you do so, you must provide them with the entire set of this software. These include:
MIDILOOP.UCD
MIDILOOP.U32
MIDILOOP.HLP
This software is freeware, you may not charge for distribution!
When distributing this software with your non-commercial application, your installation routine should place this software in your users' WINDOWS\SYSTEM directory.
If you are distributing your application as a 16bit version, you should include the UCD file. If you are distributing a 32bit version then you should include the U32 file.

About alPicView
-----------------

alPicView is an activeX control for Macromedia Authorware which allows the
display of external images. It can read graphic files in these formats: BMP,
ICO, GIF, JPG and WMF. Images of "any" size can be displayed within the
activeX control's window. Should the image be larger than the window then
scrollbars can be set to automatically display to allow the user to move
about the image.

It includes these features:

* zooming in an out

* automatic display of scrollbars

* user draggable image (panning within the activeX control's window)

* control of scrolling/panning and zooming using code

* draw simple shapes onto an image using code

* adjustment for brightness and contrast


Trial Version
-------------

A fully functional evaluation version of alPicView, and additional
information, can be found at

www.apixel.com/section05.htm#alpicview

Also available for download is the documentation and an Authorware sample
file.


We look forward to your comments, suggestions, ideas and any questions you
might have.

regards
Andrew Poulos
Apixel Pty Ltd


控件下载：
www.apixel.com/Products/picView.zip

范例下载：
Authorware v.5 Example File .zip (293K)
www.apixel.com/Products/pic_aw5.zip
Authorware v.6 Example File .zip (288K)
www.apixel.com/Products/pic_aw6.zip

帮助文件：
www.apixel.com/Products/pic_hlp.zip

功能多多。。很值的一试的图片控制扩展！！！

This list covers Windows 3.6 and Macintosh 1.5

Information functions
Version returns version info (OS, NT, DOS, QuickTime, VFW)
SysFolder returns location of system folders (windows, system, temp, etc)
CpuInfo gets information (type, speed) about the processor installed
DiskInfo gets information (type, size, name, number) about a disk
DiskList reurns list of mounted disks
FindApp finds the application associated with a file type
ReadIni reads an ini file
WriteIni writes an entry to an ini file
DeleteIniEntry deletes entry from an ini file
DeleteIniSection deletes entire section from an ini file
FlushIni forces Windows to write an ini file to disk
ReadRegString reads Registry string value
WriteRegString writes string value to the Registry
ReadRegNumber reads Registry number value
WriteRegNumber writes number value to the Registry
ReadRegBinary reads Registry binary value
WriteRegBinary writes binary value to the Registry
ReadRegMulti reads Registry multi string value
WriteRegMulti writes multi string value to the Registry
DeleteReg deletes Registry entry
RegKeyList returns a list of sub-keys inside a registry key
RegvalueList returns a list of values inside a registry key
SoundCard checks whether a sound card is installed
FontInstalled checks whether a font is installed
FontList returns a list of installed fonts
FontStyleList returns a list of available styles for a truetype font
CommandArgs returns the command line arguments the application was started with
Previous checks whether a previous instance is running
ScreenInfo gets information (width, height, etc) of the screen
MultiDisplayInfo gets information (width, height, etc) of the screen
MultiDisplayList gets list of installed monitors
MemoryInfo returns information about the system memory
Gestalt returns gestalt value
GestaltExists checks whether a gestalt is available

System functions


DisableDiskErrors disables the 'Drive not ready' error message
DisableKeys disables/enables key presses
DisableMouse disables/enables mouse clicks
DisableSwitching disables/enables task switching
DisableScreenSaver disables/enables the screen saver
ScreenSaverTime sets the screen saver time out
SetScreenSaver sets the screen saver
SetWallpaper sets the desktop wallpaper
SetPattern sets the desktop pattern
SetDisplay sets the screen size and depth
SetDisplayEx sets the screen size and depth
SetMultiDisplay Sets the screen size and depth
ExitWindows exits or restarts Windows
RunProgram runs an external program
WinHelp shows a Windows help file
MsgBox shows standard message box
MsgBoxButtons changes text on MsgBox buttons
MsgBoxEx shows custom message box
Prompt asks for a string input
HideTaskBar shows/hides the Win95 task bar
SetCurrentDir changes the DOS current directory
CopyText copies text to the clipboard
PasteText pastes text from the clipboard
EncryptText encrypts a text string
DecryptText decrypts a text string
PlaceCursor positions the cursor
RestrictCursor restricts the cursor to a specific screen area
FreeCursor allows the cursor to move anywhere on the screen
SetVolume sets the volume of wave and midi files and audio CD
GetVolume gets the current sound volume of wave and midi files and audio CD
Environment gets the value of an environment variable
SetEnvironment sets the value of an environment variable
Administrator returns administrator status
UserName returns the current user
ComputerName returns the computer network name
InstallFont installs TrueType or bitmap font
Sleep pauses the calling Directof/Authorware program
SystemTime returns the current system time/date
SetSystemTime sets the system time/date
KeyIsDown checks whether a key is being held down
KeyBeenPressed checks whether a key has been pressed
CreatePMGroup creates a Program Manager or Start Menu group
DeletePMGroup deletes a Program Manager or Start Menu group
PMGroupList returns a list of all Program Manager groups
PMSubGroupList returns a list of all groups inside another group
CreatePMIcon creates a Program Manager or Start Menu icon
DeletePMIcon deletes a Program Manager or Start Menu icon
PMIconList returns a list of all the icons in a Program Manager group
PrinterInfo returns information about the installed printer
SetPrinter changes settings for the default printer
PrintDlg shows standard print dialog
PageSetUpDlg shows standard page set up dialog
RefreshDesktop refreshes the desktop icons
EjectDisk ejects a disk

File functions


FileAge returns the age of a file
FileExists checks whether a file exists
FolderExists checks whether a folder exists
IsBundle checks if a file is a bundle
CreateFolder creates a new folder
DeleteFolder deletes an empty folder
FolderSize returns the size of a folder
RenameFile renames a file
DeleteFile deletes a file
DeleteXFiles deletes files with wildcard matching
XDelete deletes files with wildcard matching, including sub-directories
FileDate returns the date of a file
FileDateEx returns the date of a file
FileSize returns the size of a file
FileAttributes returns the set attributes of a file
SetFileAttributes sets the attributes of a file
RecycleFile places a file in the Win95/NT recycle bin
MoveOnReboot moves a file on system reboot
CopyFile copies a file
CopyXFiles copies multiple files with wildcard matching
XCopy copies multiple files with wildcard matching including sub-directories
CopyFileProgress copies a file with a progress bar
CopyXFilesProgress copies multiple files with wildcard matching, with a progress bar
CopyXFilesProgress copies multiple files with wildcard matching including sub-directories, with a progress bar
FileVersion returns the version of a file
FileList returns a list of files in a folder
FolderList returns a list of folders inside another folder
FindFirstFile searches drive for a file
EncryptFile encrypts/decrypts a file
FindDrive searches all drives for a specified file
GetFilename displays a file selection dialog
GetFolder displays a folder selection dialog
GetDisk displays a disk selection dialog
OpenFile opens a file using it's associated program
Shell executes a file
OpenURL opens a URL using the default browser
PrintFile prints a file using it's associated program
ShortFileName returns the short version of a file name
LongFileName returns the long version of a file name
TempFileName returns a temporary file name guaranteed not to exist
MakeShortcut creates a shortcut/alias
MakeShortcutEx creates a shortcut
ResolveShortcut returns the file a shortcut points to
FileCreator returns the file creator type
FilePermissions returns UNIX file permissions
SetFilePermissions sets UNIX file permissions
FileType returns the file type
SetFileInfo sets the creator and type for a file

Window functions


WindowInfo returns info (state, size, postion, title, class) of a window
FindWindow finds a window with given title or class
WindowList returns a list of all windows with given title or class
ChildWindowList returns a list a window's child windows
ActiveWindow returns the active window
WaitForWindow waits until a specified window is in a specified state
WaitTillActive waits until a specified window becomes the active one
NextActiveWindow returns the next window to become active
CloseWindow closes a window
CloseApp closes the application owning a window
WindowExists checks that a window handle is valid
SetWindowState minimises, maximises, hides a window
ActivateWindow activates the specified window
SetWindowTitle set the caption of a window
MoveWindow moves/resizes a window
WindowToFront brings the window to the front
WindowToBack sends the window to the back
WindowDepth gets the z-order depth of a window
SetWindowDepth sets the z-order depth of a window
GetWindow finds a window related (child, parent, etc) to another window
SetParent makes a window a child of another window
ClipWindow removes edges from window
WaitTillActive waits until a specified window becomes the active one
SendKeys sends simulated key presses to the active window
SendMsg sends a windows message to a window
AddSysItems adds System menu, min and max boxes
RemoveSysItems removes System menu, min and max boxes
WinHandle returns the Director stage or Authorware presentation window
StageHandle returns the Director stage window