authware函数1
Authorware函数分类
Autorware的系统函数有大致有18类：Character（字符管理函数）、CMI（计算机学习管理函数）、（File）文
件管理函数、Framework（框架管理函数）、Ceneral（一般目的函数）、Graphic（绘图函数）、Icons（图标管
理函数）、Jump（跳转函数）、Language（编程语言函数）、List（列表排序索引函数）、Math（数学运算函数
）、Network（网络管理函数）、OLE（管理函数）、Platform（平台管理函数）、Target（目标函数控制图标的
属性）、Time（时间管理函数）、Video（视频管理函数）、Xtras（使用、控制Xtras文件，取得Xtras文件信息
）。以下我们选择一些与课件制作相关的函数作简单介绍。
一、数学函数
ABS()
格式：number:= ABS(x)
说明：返回x的绝对值。
ACOS()
格式：number:= ACOS(x)
说明：返回x的反余弦函数值，x的值的范围为0～Pi。
ArrayGet
格式：result:= ArrayGet(n)
说明：读取一个排列中的第n个单元，并将它赋给变量result，该单元可以是一个字符串或数字。
Array()
格式：MyArray:= Array(value, dim1 [, dim2, dim3, ...dim10])
说明：该函数用来创建一个列表，可以创建多维列表。
ArraySet(n, value)
格式：ArraySet(n, value)
说明：将Value的值插入到一个排列列表中第n的位置。
ASIN
格式：number:= ASIN(x)
说明：计算x的反正弦值。
ATAN
格式：number:= ATAN(x)
说明：计算x的反正切值。
Average
格式：
1. Value:= Average(anyList)
2. Value:= Average(a [, b, c, d, e, f, g, h, i, j])
说明：取得参数列表中各参数的平均值。
COS
格式：number:= COS(angle)
说明：计算x的余弦值，将值赋给number，其中x为角度，单位是弧度。
EXP
格式:number:=EXP(x)
说明：将的e次幂x的值赋给number.
EXP10
格式:number:=EXP10(x)
说明：将10的x次幂的值赋给number.
Fraction
格式：result:=Fraction(number)
说明：该函数返回number数值中的小数点后的内容，包括小数点。例如：Result:= Fraction(12.34)，Result
的值为“.34”。
INT
格式：number:= INT(x)
说明：对数x取整，例如：INT(3.14) 返回值 3。INT("1a2b3c") 返回值123。
LN
格式：number:= LN(x)
说明：该参数x取自然对数的值。
LOG10
格式：number:= LOG10(x)
说明：该函数返回x的以10为底的对数的值。
Max
格式：value:= Max(anyList)
value:= Max(a [, b , c, d, e, f, g, h, i, j])
说明：取列表中，或各参数中的最大值。
Min
格式：value:= Min(anyList)
value:= Min(a [, b, c, d, e, f, g, h, i, j])
说明：返回列表中，或各参数中的最大值。
MOD
格式：number:= MOD(x, y)
说明：该函数返回x/y的余数。例如：将24小时制的时间转化为12小时制的时间：Hours:= Mod(2300/100,12)
Number
格式：number:= Number(x)
说明：该函数将参数x转化为一个实型或整型的数值。例如：Number("1a2b3c") 返回值为123。
Random
格式：number:= Random(min, max, units)
说明：该函数产生范围在min 之间max，小数点后类似units的随机数。
Real
格式：realNum:= Real(x)
说明：将参数x转化为实型。
Round
格式：number:= Round(x [, decimals])
说明：该函数按照decimals设定的小数位数来实现四舍五入的算法。
Sign
格式：number:= Sign(x)
说明：当x为负时，该函数返回值为－1。当x为0时，该函数返回值为0。当x为正时，该函数返回值为1。
SIN
格式：number:= SIN(angle)
说明：该函数取角度的正弦值。
SQRT
格式：number:= SQRT(x)
说明：该函数返回参数x的平方根。
Sum
格式：value:= Sum(anyList)
value:= Sum(a [, b, c, d, e, f, g, h, i, j])，
说明：该函数返回列表中或各参数(最多10个)的值的累加。例如List:= [10, 20, 30]
TotalValue:= Sum(List)，其值为60。
TAN
格式：number:= TAN(angle)
说明：该函数返回角度angle的正切值。
二、列表函数
AddLinear
格式：AddLinear(linearList, value [, index])
说明：该函数的作用是将Value插入到Linearlist（线型列表）中。
如果该线型列表是一个有序的列表，则Value被按照一定的规则插入到合适的位置。
如果该列表为一个无序的列表，则将Value插入的列表的最后。
如果index的值为1，则Valve被插入到列表第一个。
如果index的值超过列表中的个数，则越界的个数用零补全，然后再插入Value。
AddProperty
格式：AddProperty(propertyList, #property, value [, index])
说明：该函数的作用是将属性或值插入到属性列表中。
Array()
格式：MyArray:=Array(value,dim1[dim2,dim3,dim4,…dim10])
说明：该函数用来创建一个列表，并可以为多维的列表.
CopyList
格式：newList:= CopyList(anyList)
说明：该函数实现列表的完全拷贝，生成一个新的列表。
DeleteAtIndex
格式：DeleteAtIndex(anyList, index)
说明：该函数按照索引从列表中删除一个特定的元素。例如：anyList:= [1, 2, 3]，DeleteAtIndex(anyList,
1)，anyList 的值改变为[2, 3]。
DeleteAtProperty
格式：DeleteAtProperty(propertyList, #property)
说明：该函数删除在列表中第一个具有特定属性的元素。
FindProperty
格式：index:=FindProperty(propertyList, #property, [index])
说明：该函数返回具有属性的列表中，从index往后第一个具有特定属性的字符串的位置。
FindValue
格式：
index:= FindValue(anyList, value [, index])
说明：该函数返回在列表中，从index往后寻找第一个具有指定值的字符串的位置。如果没有寻找到同value相同
的字符串或anylist参数不是一个列表，则该函数返回值为“0”。
InflateRect
格式：InflateRect(rectangle, widthChange, heightChange)
说明：该函数改变指定矩形的大小，widthChange为对宽度的变化值，heightChange为对矩形高度的改变值，负
值为对矩形大小的缩小，正值为对矩形大小的增加。每一单位数值代表两个像素。
Intersect
格式：newRectangle:= Intersect(rectangle1, rectangle2)
说明：从两个矩形的交叉点，创建一个新的矩形。
List
格式：List(value)
说明：将指定值从当前数据类型转变成列表型，所出现的语法错误将被存储在系统变量EvalStatus和
EvalMessage中。
ListCount
格式：number:=OffsetRect(rectangle,x,y)
说明：返回anyList指定的列表中元素的数目。如果anyList参数不是列表，返回值为0。
OffsetRect
格式：NewRectangle:= OffsetRect(rectangle, x, y)
说明：该函数的作用是按照rectangle的形状复制一个矩形，矩形的位置由原矩形的位置和参数x，y来决定，参
数x，y是新矩形相对原矩形移动的位置，当x大于零时，新建矩形在原矩形的右边，当y大于零时，新建矩形在原
矩形的下方。当参数小于零时，位置相反。
Point
格式：MyPoint:= Point(x, y)
说明：在屏幕坐标(x，y)上创建一个点。
PointInRect
格式：result:= PointInRect(rectangle, point)
说明：如果指定的点point在矩形rectangle内，该函数返回值为TRUE，否则为FALSE。
PropertyAtIndex
格式：Property:= PropertyAtIndex(propList, index)
说明：该函数返回在具有属性的列表中选择由index所指定的元素。
Rect
格式：MyRect:= Rect(value1, value2, value3, value4)
MyRect:= Rect(point, point)
说明：利用指定的值或点来绘制矩形。
SetAtIndex
格式：SetAtIndex(anyList, value, index)
说明：该函数用来替换指定列表中指定位置的元素的值。
SortByProperty
格式：SortByProperty(propertyList1[, propList2,..., propList10][, order])
说明：将属性列表按照属性和标记作为标准来排序，将参数order设置为TRUE时，对列表进行升序排列，当order
设置为FALSE时，对列表进行降序排列。
SortByValue
格式：
SortByValue(anyList1 [, anyList2, ..., anyList10], [order])
说明：该函数的作用同上一函数的作用基本相同，对列表中的元素按照它们的值和标记来进行排序分类，将参数
order设置为TRUE时，对列表进行升序排列，当order设置为FALSE时，对列表进行降序排列。
UnionRect
格式：NewRect:= UnionRect(rectangle1, rectangle2)
说明：该函数返回矩形rectangle1，rectangle2中最小的一个。
ValueAtIndex
格式：ValueAtIndex(anyList, index)
说明：该函数返回指定列表中指定位置的值。
三、文件管理函数
AppendExtFile
格式：number:= AppendExtFile("filename", "string")
说明：该函数将字符串中的值插入到一个文件的末尾。
Catalog
格式：string:= Catalog("folder")
或string:= Catalog("folder"，“D”)或string:= Catalog("folder"，“F”)
说明：将folder文件夹中的子文件夹和文件名以字符串的形式赋给变量string。
或将folder文件夹中的子文件夹以字符串的形式赋给变量string。
或将folder文件夹中的文件名以字符串的形式赋给变量string。
CreateFolder
格式：number:= CreateFolder("folder")
说明：使用该函数来创建一个有folder指定名称的文件夹，缺省情况下，该文件夹是当前文件夹的子文件夹。文
件运行后，Authorware改变两个系统变量IOStatus 和IOMessage，用来存储该函数的执行信息，如果没有错误，
IOStatus的返回值为0，而IOMessage为空。如果有错误，IOStatus 的返回值不为0，IOMessage中存储的是错误
信息。
DeleteFile
格式：number:= DeleteFile("filename")
说明：该函数的作用是删除filename所指定的文件，在删除文件时，请带上文件的扩展名，避免发生误删除。函
数运行后，Authorware改变两个系统变量IOStatus 和IOMessage，用来存储该函数的执行信息，如果没有错误
IOStatus的返回值为0，而IOMessage为空。如果有错误，IOStatus 的返回值不为0， IOMessage中存储的是错误
信息。
FileType
格式：number:=FileType(“filename”)
说明：该函数的结果是返回一个数字，该数字代表文件或文件夹的不同类型。
0表示无此文件或错误。
1表示目录（文件夹）。
3表示不包含RunA6W打包文件（.A6R）。
4表示模板文件（.A6D）。
5表示声音文件（.AIF，.PCM，或.WAV）。
6表示数字电影文件（.MOV，.AVI，.MPG，.DIR）。
7表示PICS电影文件。
8表示用户代码（.UCD或.DLL）。
9表示文本文件（.TXT）
10表示应用程序文件（，.COM，.BAT，.PIF）。
11表示其他文件。
12表示库文件（.A6E）。
13表示打包后的库文件（.A6E）。
14表示图形文件。
15表示外挂(Xtra)文件。
ReadExtFile
格式：string:= ReadExtFile("filename")
说明：该函数的作用是读取文件filename中的内容，并将该内容赋给变量string。
RenameFile
格式：number:= RenameFile("filename", "newfilename")
说明：该函数的功能是将文件filename更名为newfilename
WriteExtFile
格式：number:= WriteExtFile("filename", "string")
说明：该函数的作用是将字符串string中的内容写入由filename所在指定的文件中。
四、开发平台函数
Application
格式：string:= Application()
说明：该函数的返回值为COA加上一个空格，它是Authorware的源文件名。某些XCMDs 和 DLLs需要来决定
Authorware是否正在运行。
CloseWindow
格式：CloseWindow("window")
说明：该函数的作用是关闭有“Window”所指定的窗口，该函数时由XCMD 或 UCD (DLL)所生成的。
GetProperty
格式：
value:= GetProperty("window", #property)
说明：该函数的作用是取得window指定的窗口属性的值，该窗口是由XCMD 或 UCD (DLL)所产生的。
GetSpriteProperty
格式：
result:= GetSpriteProperty(IconID@"SpriteIconTitle", #property)
说明：该函数取得一个sprite属性的值。
SetProperty
格式：SetProperty("window", #property, value)
说明：该函数用于设置指定窗口的特征值。Window参数表示由XCMD或UCD(DLL)生成的窗口名。
TestPlatform
格式：string:= TestPlatform(Mac, Win32 [, Win16])
说明：该函数返回应用程序所运行的平台信息。
ZoomRect
格式：ZoomRect(x, y)
说明：该函数的作用是使Authorware从(x,y)点到显示对象的边缘产生变焦距显示的效果。
五、通用函数
Beep()
格式：Beep()
说明：使系统响铃。
CallIcon
格式：result:= CallIcon(IconID@"SpriteIconTitle", #method [, argument...])
说明：该函数用来调用带有Sprite Xtra功能的进程。
CallObject
格式：result:= CallObject("object", #method [, argument...])
说明：该函数调用一个对象的Scripting Xtra句柄，我们可以使用NewObject来创建一个新的对象。
CallParentObject
格式：result:= CallParentObject("Xtra", #method [, argument...])
说明：调用一个具有Sprite Xtra的进程。
CallSprite
格式：result:= CallSprite(IconID@"SpriteIconTitle", #method [, argument...])
说明：调用一个Sprite进程。
CallTraget
格式：Result:=CallTarget(SystemFunctionName[,argument,…])
说明：用目标程序中给出的参数求指定系统函数的值并返回。如果调用失败，返回0。该函数只能用于wizard程
序中的计算图标。
DeleteObject
格式：DeleteObject(object)
说明：该函数删除一个由NewObject创建的Scripting Xtra对象。
FlushEventQueue
格式：FlushEventQueue()
说明：该函数将事件队列中等待执行的某事件取消掉。
FlushKeys
格式：FlushKeys()
说明：该函数的作用是忽略最终用户按下的任何键。
GetIconProperty
格式：result:= GetIconProperty(IconID@"SpriteIconTitle", #property)
说明：该函数返回指定图标SpriteIconTitle中，指定属性的值。
GetSpriteproperty
格式：result:=GetSpriteProperty(IconID@”SpriteIconTitle”,#property)
说明：该函数取得一个精灵图标属性的值。
Initialize
格式：Initialize([variable1, variable2, …variable10])
说明：将variable1, variable2等变量的值恢复成为初始化值。
MediaPause
格式：MediaPause(IconID@"IconTitle", pause)
说明：该函数的作用是暂停或继续播放在指定图标中的数字化电影，参数pause为TRUE时，暂停播放，参数pause
为FALSE时，Authorware将继续播放。
MediaPlay
格式：MediaPlay(IconID@"IconTitle")
说明：该函数是使指定图标中的数字化电影开始播放。
MediaSeek
格式：MediaSeek(IconID@"IconTitle", position)
说明：该函数的作用是设置指定图标中数字化电影的帧数，使Authorware直接定位该帧的图像。
MoveWindow
格式：MoveWindow(top, left)
说明：该函数只能在计算图标设计窗口中使用，不能作为装饰或在表达式中使用，该函数的作用是将展示窗口遇
到到指定的位置。
NewObject
格式：object:= NewObject("Xtra" [, arguments...])
说明：该函数创建一个新的Scripting Xtra并通过参数的设置来调用一个实例启动。
NumCount
格式：number:= NumCount("string")
说明：该函数返回在字符串string中数字的个数。例如：NumberTotal:= NumCount
("Greg11Peter22Bobby33Marcia44Jan55Cindy66")，变量 NumberTotal 的值为 6。
PressKey
格式：PressKey("keyname")
说明：当在该函数中指定一个键盘按键名后，Authorware执行该函数的效果同最终用户在键盘上按下指定的按键
的功能相同。
PrintScreen
格式：PrintScreen()
说明：将当前屏幕上显示的对象直接从设定的打印机上打印输出。
Quit
格式：Quit([option])
说明：该函数的功能是使Authorware直接退出演示过程。Option参数的数字含义如下所述：
0表示返回到Authorware窗口。
1表示返回到Windows环境，如果在演示过程中是从一个文件跳转到另一个文件，将返回到先前的文件。
2表示返回到DOS环境。
QuitRestart
格式：QuitRestart([option])
说明：该函数是使Authorware退出展示过程返回DOS或Windows环境以后，重新开始运行当前的交互作用应用程序
。
ResizeWindow
格式：ResizeWindow(width, height)
说明：重新设置展示窗口的大写。
SaveRecords
格式：SaveRecords()
说明：该函数将用户的信息保存在磁盘上，当用户退出一个文件后，Authorware自动地执行保存功能。
SendEventReply
格式：SendEventReply(event, reply)
说明：对由Xtras发出的事件发送一个回应。
SetCursor
格式：SetCursor(Type)
说明：该函数的作用是设定鼠标指针的具体形状：参数type不同的值，其响应鼠标形状为：
SetCursor(0) 箭头
SetCursor(1) “I”形
SetCursor(2) 双箭头形状
SetCursor(3) 加号形状
SetCursor(4) 方块
SetCursor(5) 沙漏形状 (Windows)
SetCursor(6) 手的形状
SetIconProperty
格式：SetIconProperty(IconID@"SpriteIconTitle", #property, Value)
说明：该函数用来设置sprite icon's asset.的属性值，该值可以通过GetIconProperty函数来取得。
SetKeyboardFocus
格式：SetKeyboardFocus(IconID@"IconTitle")
说明：该函数将当前的焦点放置到指定的sprite 图标, 正文输入响应， Director 电影图标等。
SetSpriteProperty
格式：SetSpriteProperty(IconID@"SpriteIconTitle", #property, value)
说明：设置由sprite图标当前显示的sprite的属性的值。
ShowCursor
格式：ShowCursor(display)
说明：该函数的功能是显示或隐藏鼠标，参数display为ON时，显示鼠标，参数display为OFF时，隐藏鼠标。
ShowMenuBar
格式：ShowMenuBar(display)
说明：该函数用于显示或隐藏展示窗口中的用户菜单。该函数仅能在计算图标设计窗口中使用，不能作为装饰或
在表达式中使用。
ShowTaskBar
格式：ShowTaskBar(display)
说明：该函数的功能是显示或隐藏用户任务栏，要显示用户任务栏，将display设置为ON，否则设置为OFF。该函
数仅能在计算图标设计窗口中使用，不能作为装饰或在表达式中使用。
ShowTitleBar
格式：ShowTitleBar(display)
说明：该函数的功能是显示或隐藏用户的标题栏，要显示用户的标题栏，将display设置为ON，否则设置为OFF。
该函数仅能在计算图标设计窗口中使用，不能作为装饰或在表达式中使用。
ShowWindow
格式：ShowWindow(display)
说明：打开或关闭显示窗口。OFF关闭，ON打开。
SyncWait
格式：SyncPoint(option)和SyncWait(seconds)
说明：这两个函数是相互配合起来使用，SyncWait(seconds) 用来设置一个等待时间，seconds为等待时间的秒
值。在等待的时间范围内，所有的交互作用响应均暂时不能使用，当如数字化电影、动画及其它操作仍然可以继
续。SyncPoint(option)用于设定在何时对SyncWait(seconds)函数设置的等待时间进行计时。参数option的含义
如下所述：
0表示在当前显示图标显示按钮中的内容前开始计时。
1表示在显示当前图标中的内容后开始计时。
2表示在用户匹配一个响应或退出一个交互作用分支结构时，开始计时(该数字标识仅用于交互作用分支结构)。
Test
格式：Test(condition, trueExpression [, falseExpression])
说明：该函数的功能是，当condition的值为TRUE时，Authorware计算true expression中的表达式，当
condition的值为FALSE时，Authorware计算false expression中的表达式。
例如：Test(Score《50, path:=1, path:=2)，如果Score小于50，则为path赋值为1，否则赋值为2。
TextCopy,
格式：TextCopy()
说明：该函数的作用是将当前选中的正文复制到剪贴板中。
TextCut
格式：TextCut()
说明：该函数的作用是将当前选中的正文剪贴到剪贴板中。
TextPaste
格式：TextPaste()
说明：该函数的作用是将剪贴板中的内容粘贴到当前激活的正文对象中。
Trace
格式：Trace("string")
说明：该函数的作用是帮助程序的调试，该函数在独立的计算图标设计窗口中使用，我们可以在要调试的图标前
加上一个计算图标设计窗口，并在该图标中输入该函数，当Authorware遇到该函数时，会自动跳出跟踪窗口，同
时，参数string所设定的字符串会出现在窗口中。
TypeOf
格式：Type: = TypeOf(value)
说明：该函数返回参数value的类型。参数的类型有如下所述几种：
#integer ; #real; #string ; #linearList; #propList ; #rect; #point; #symbol; #event
例如：TypeOf([1, 2, 3]) 返回值为：#linearList，TypeOf(#a) 返回值为：#symbol，TypeOf("abc") 返回值
为：#string。
WaitMouseUp
格式：WaitMouseUp()
说明：该函数暂停展示窗口中的内容，直到用户松开鼠标左键为止。