Authorware中的函数.docx
《Authorware中的函数.docx》由会员分享，可在线阅读，更多相关《Authorware中的函数.docx（80页珍藏版）》请在冰豆网上搜索。
Authorware中的函数
Authorware中的函数
Authorware中系统自带的函数有三百多个，以下列出以便大家使用时查看：
函数
类别
使用格式及说明
ABS（）
Math
格式：
number:
=ABS（x）
说明：
返回x的绝对值
ACOS（）
Math
格式：
number:
=ACOS（x）
说明：
返回x的反余弦函数值，x的值的范围为0～Pi。
AddLinear
List
格式：
AddLinear（linearList,value[,index]）
说明：
该函数的作用是将Value插入到Linearlist（线型列表）中。
如果该线型列表是一个有序的列表，则Value被按照一定的规则插入到合适的位置；
如果该列表为一个无序的列表，则将Value插入的列表的最后；
如果index的值为1，则Valve被插入到列表第一个；
如果index的值超个列表中的个数，则越界的个数用零补全，然后再插入Value。
例如：
1：
numList:
=[1,2,3]
AddLinear（numList,99,1）
numList的结果是[99,1,2,3]
2：
numList:
=[1,2,3]
AddLinear（numList,99,6）
NumListisnow[1,2,3,0,0,99]
AddProperty
List
格式：
AddProperty（propertyList,#property,value[,index]）
说明：
该函数的作用是将属性或值插入到属性列表中。
例如：
1：
propList:
=[#a:
1,#b:
2,#c:
3]
AddProperty（propList,#d,99,1）
PropList为：
[#d:
99,#a:
1,#b:
2,#c:
3]
2：
propList:
=[#a:
1,#b:
2,#c:
3]
AddProperty（propList,#d,99,6）
propList为：
[#a:
1,#b:
2,#c:
3,#d:
99]
AppendExtFile
File
格式：
number:
=AppendExtFile（"filename","string"）
说明：
该函数将字符串中的值插入到一个文件的末尾。
例如：
AppendExtFile（RecordsLocation^"DATA.TXT",NewUser），将新的字符串NewUser加入到DATA.TXT中。
Application
Platform
格式：
string:
=Application（）
说明：
该函数的返回值为COA加上一个空格，COA即CourseofAction，它是Authorware的源文件名。
某些UCD和DLL可通过使用该函数来确定Authorware是否正在运行。
ArrayGet
Math
格式：
result:
=ArrayGet（n）
说明：
读取一个排列中的第n个单元，并将它赋给变量result，该单元可以是一个字符串或数字。
Array（）
Math
格式：
MyArray:
=Array（value,dim1[,dim2,dim3,...dim10]）
说明：
该函数用来创建一个列表，可以为多维的列表的创建。
例如，我们创建一个三维的列表：
MyArray:
=Array（0,4,3,2）
结果是：
[[[0,0],[0,0],[0,0]],[[0,0],[0,0],[0,0]],[[0,0],[0,0],[0,0]],[[0,0],[0,0],[0,0]
ArraySet（n,value）
Math
格式：
ArraySet（n,value）
说明：
将Value的值插入到一个排列列表中第n的位置。
ASIN
Math
格式：
number:
=ASIN（x）
说明：
计算x的反正弦值，
ATAN
Math
格式：
number:
=ATAN（x）
说明：
计算x的反正切值
Average
Math
格式：
Value:
=Average（anyList）
Value:
=Average（a[,b,c,d,e,f,g,h,i,j]）
说明：
取得参数列表中各参数的平均值，例如：
1：
numList:
=[1,2,3,99]
Value:
=Average（numList）
Value的值为26.
2：
Value:
=Average（1,2,3,99）
Value的值为26.
Beep（）
General
格式：
Beep（）
说明：
使系统响铃
Box（）
Graphics
格式：
Box（pensize,x1,y1,x2,y2）
说明：
该函数用来在（x1，y1），（x2，y2）两点中间绘制一个方框，方框的线型粗细由pensize参数决定，线型默认的颜色为黑色，方框默认为无填充色，使用SetFrame和SetFill
函数来设置线型的颜色和填充色。
CallIcon
General
格式：
result:
=CallIcon（IconID@"SpriteIconTitle",#method[,argument...]）
说明：
该函数用来调用带有spriteXtra功能的进程。
CallObject
General
格式：
result:
=CallObject（"object",#method[,argument...]）
说明：
该函数调用一个对象的scriptingXtra句柄，我们可以使用NewObject来创建一个新的对象。
CallParentObject
General
格式：
result:
=CallParentObject（"Xtra",#method[,argument...]）
说明：
调用一个具有spriteXtra的进程。
CallSprite
General
格式：
result:
=CallSprite（IconID@"SpriteIconTitle",#method[,argument...]）
说明：
调用一个sprite进程。
Capitalize
Character
格式：
resultString:
=Capitalize（"string"[,1]）
说明：
该函数的功能是将字符串中每一个单词的首写字母转变成大写字母，Authorware自动分辨单词之间的空格。
如果我们需要只转化字符串的第一个单词的第一个字母，可以使用参数“1”。
例如：
EntryText="theraininspain"
Name:
=Capitalize（EntryText）
函数的结果为：
"TheRainInSpain"
Name:
=Capitalize（EntryText,1）
函数的结果为：
"Theraininspain"
Catalog
File
格式：
1：
string:
=Catalog（"folder"）
2：
string:
=Catalog（"folder"，“F”）
3：
string:
=Catalog（"folder"，“F”）
说明：
1：
将folder文件夹中的子文件夹和文件名以字符串的形式赋给变量string。
2：
（D）将folder文件夹中的子文件夹以字符串的形式赋给变量string。
3：
（F）将folder文件夹中的文件名以字符串的形式赋给变量string。
CharCount
Character
格式：
number:
=CharCount（"string"）
说明：
返回字符串中的字符的个数，包括空格和特殊字符。
例如：
MyString:
="abc"
Number:
=CharCount（MyString）
Number的值为5。
Char
Character
格式：
string:
=Char（key）
说明：
该函数取Key所指定按键的名称或数值，然后以字符的形式赋给管理Sting。
ChildIDToNum
Icons
格式：
number:
=hildIDToNum（IconID@"ParentTitle",@"ChildTitle"[,flag]）]
说明：
该函数返回一个数值，用来标记由ChildTitle所指定的在【映射】设计按钮或附属于分支结构的ParentTitle结构中的相对位置，ParentTitle代表的是【映射】设计按钮或具有分支功能的设计按钮的标题名。
在Authorware中，【映射】设计按钮包含的设计按钮按照从上至下的顺序进行标记，最顶端的设计按钮位置为1，其它的设计按钮依次类推；
【交互作用】分支结构中是按照从左至右的顺序来标记，位于最左边的反馈按钮相对位置为1，其它依次类推。
对于【框架】设计按钮，其分支结构分三种情况：
1：
当参数flag＝0时，ChildTitle必须是页所对应的设计按钮的标题，这些页的相对位置是从左至右的顺序进行标记；
2：
当参数flag＝1时，ChildTitle是框架内部结构输入画面中设计按钮的标题，其相对位置是从左至右的顺序进行标记；
3：
当参数flag＝2时，ChildTitle是框架内部结构退出画面中设计按钮的标题，其相对位置是从左至右的顺序进行标记；
ChildNumToID
Icons
格式：
ID:
=ChildNumToID（IconID@"Parent",n[,flag]）
说明：
该函数的作用是返回【映射】设计按钮、【交互作用】设计按钮、【框架】结构中相对位置为n处的设计按钮的ID表示，参数flag的含义同上所述。
Circle
Graphics
格式：
Circle（pensize,x1,y1,x2,y2）
说明：
在左上角坐标为（x1,y1），右下角坐标为（x2,y2）的方框内绘制同该方框相内切的圆，我们可以使用SetFrame和SetFill函数来调整线型的颜色和填充色；
当pensize<0时，圆内以黑色填充；
当pensize＝0size="2"LANG="ZH-CN">时，圆内以白色填充；
当pensize,>0时，圆周线条的宽度等于pensize,指定的像素点的值，圆内没有填充色。
CloseWindow
Platform
格式：
CloseWindow（"window"）
说明：
该函数的作用是关闭有“Window”所指定的窗口，该函数时由XCMD或UCD（DLL）所生成的。
Code
Character
格式：
number:
=Code（"character"）
说明：
该函数的作用是返回"character"所对应的ASCII码，
例如：
Code（d）的返回值为100。
CopyList
List
格式：
newList:
=CopyList（anyList）
说明：
该函数实现列表的完全拷贝，生成一个新的列表，列表拷贝和列表赋值的不同：
使用列表拷贝，对新列表的改变不影响源列表的内容；列表的赋值生成新列表，对新列表的改变会影响源列表的内容。
例如：
1、列表的拷贝：
ListA:
=[10,20,30]
ListB:
=CopyList（ListA）
DeleteAtIndex（ListB,1）
ListA内容不变，而ListB为[20,30]
2赋值生成列表：
ListA:
=[10,20,30]
ListB:
=ListA
DeleteAtIndex（ListB,1）
ListA和ListB的值都是[20,30]。
COS
Math
格式：
number:
=COS（angle）
说明：
计算x的余弦值，将值赋给number，其中x为角度，单位是弧度。
CreateFolder
File
格式：
number:
=CreateFolder（"folder"）
说明：
使用该函数来创建一个有folder指定名称的文件夹，缺省情况下，该文件夹是当前文件夹的子文件夹。
文件运行后，Authorware改变两个系统变量IOStatus和IOMessage，用来存储该函数的执行信息，如果没有错误IOStatus的返回值为0，而IOMessage为空；如果有错误，IOStatus的返回值不为0，IOMessage中存储的是错误信息。
Date
Time
格式：
string:
=Date（number）
说明：
参数number中存储的是总的天数，该函数将总的天数转换成当前计算机系统的简短的日期格式。
该天数的起始时间为1900年1月1日。
在Authorware中number的范围为：
（2556849709）（January,1,1970,到June,2,2036）。
DateToNum
Time
格式：
number:
=DateToNum（day,month,year）
说明：
该函数的作用是将输入的日期同1900年1月1日的时间差转换为总的天数值。
参数day表示日期，范围为（1，31）；参数month表示月份，范围为（1，12）；参数year为年份，有效值范围为（1970，2036）
Day
Time
格式：
value:
=Day（number）
说明：
该函数的作用是自1900年1月1日算起，返回指定的总天数所对应的月中的第几天。
该函数中参数number值的范围为：
25568到49709（January1,1970到June2,2036）；
下面的例子范围1970年1月1日所对应的月中的天数：
result:
=Day（25568）
返回值为：
1。
DayName
Time
格式：
string:
=DayName（numbe）
说明：
该函数的作用是自1900年1月1日算起，返回指定的总天数所对应的星期中的星期几。
该函数中参数number的范围为：
25568到49709（January1,1970到June2,2036）；
下面的例子为1970年1月1日所对应的星期几：
result:
=Day（25568）
result的值为"Thursday".
DeleteAtIndex
List
格式：
DeleteAtIndex（anyList,index）
说明：
该函数按照索引从列表中删除一个特定的元素；例如：
anyList:
=[1,2,3]
DeleteAtIndex（anyList,1）
anyList的值改变为[2,3]。
DeleteAtProperty
List
格式：
DeleteAtProperty（propertyList,#property）
说明：
该函数删除在列表中第一个具有特定属性的元素；
例如：
1：
propList:
=[#a:
1,#b:
2,#c:
3]
DeleteAtProperty（propList,#a）
propList的值为：
[#b:
2,#c:
3]；
2：
propList:
=[#a:
1,#a:
2,#a:
3]
DeleteAtProperty（propList,#a）
PropList的值[#a:
2,#a:
3]；
3：
propList:
=[#a:
1,#A:
2,#A:
3]
DeleteAtProperty（propList,#A）
PropList的值为[#a:
2,#a:
3]。
DeleteFile
File
格式：
number:
=DeleteFile（"filename"）
说明：
该函数的作用是删除filename所指定的文件，在删除文件时，请带上文件的扩展名，避免发生误删除。
函数运行后，Authorware改变两个系统变量IOStatus和IOMessage，用来存储该函数的执行信息，如果没有错误IOStatus的返回值为0，而IOMessage为空；如果有错误，IOStatus的返回值不为0，IOMessage中存储的是错误信息。
DeleteLine
Character
格式：
1：
Result:
=DeleteLine（"string",n）
2：
Result:
=DeleteLine（"string",n,m）
3：
Result:
=DeleteLine（"string",n,m,delim）
说明：
1：
删除字符串中的第n行，返回剩下的内容；
2：
删除字符串中从第n行到第m行，然后返回剩下的内容；
3：
删除字符串中从第n行到第m行中以delim指定的分界符结尾的行，然后返回剩下的内容。
DeleteObject
General
格式：
DeleteObject（object）
说明：
该函数删除一个由NewObject创建的scriptingXtra对象。
DisplayIcon
Icons
格式：
DisplayIcon（IconID@"IconTitle"）
说明：
运行该函数，将显示IconTitle所指定的设计按钮中所有正文及图片对象显示在展示窗口中。
DisplayIconNoErase
Icons
格式：
DisplayIconNoErase（IconID@"IconTitle"）
说明：
运行该函数，将显示IconTitle所指定的设计按钮中所有正文及图片对象显示在展示窗口中，并将该设计按钮的属性设置为同【Properties】对话框中的【PreventAutoErase】选项相同的属性。
DrawBox
Graphics
格式：
1：
DrawBox（pensize）
2：
DrawBox（pensize,[x1,y1,x2,y2]）
说明：
1：
该函数设置的目的是使最终用户使用鼠标拖动的方法来绘制方框，线型的宽度由pensize来决定，用该方法使用该函数必须在热区响应区域中使用；
2：
该函数是使最终用户只能在（x1,y1），（x2,y2）所限定的范围内绘制方框，方框线型由参数pensize决定:
我们可以使用SetFrame和SetFill函数来调整线型的颜色和填充色；
当pensize<0时，方框以黑色填充；
当pensize＝0size="2"LANG="ZH-CN">时，方框以白色填充；
当pensize,>0时，方框线条的宽度等于pensize,指定的像素点的值，方框内没有填充色。
DrawCircle
Graphics
格式：
1：
DrawCircle（pensize）
2：
DrawCircle（pensize,[x1,y1,x2,y2]）
说明：
1：
该函数设置的目的是使最终用户使用鼠标拖动的方法来绘制椭圆，线型的宽度由pensize来决定，用该方法使用该函数必须在热区响应区域中使用；
2：
该函数是使最终用户只能在（x1,y1），（x2,y2）所限定的范围内绘制椭圆，椭圆线型由参数pensize决定:
我们可以使用SetFrame和SetFill函数来调整线型的颜色和填充色；
当pensize<0时，椭圆内以黑色填充；
当pensize＝0size="2"LANG="ZH-CN">时，椭圆内以白色填充；
当pensize,>0时，椭圆线条的宽度等于pensize,指定的像素点的值，椭圆内没有填充色。
DrawLine
Graphics
格式：
1：
DrawLine（pensize）
2：
DrawLine（pensize,[x1,y1,x2,y2]）
说明：
1：
该函数设置的目的是使最终用户使用鼠标拖动的方法来绘制直线，线型的宽度由pensize来决定，用该方法使用该函数必须在热区响应区域中使用；
2：
该函数是使最终用户只能在（x1,y1），（x2,y2）所限定的范围内绘制直线，直线线型由参数pensize决定:
我们可以使用SetFrame来调整线型的颜色。
EraseAll
Icons
格式：
EraseAll（）
说明：
该函数只能在【元素】设计按钮中使用，其作用是擦除展示窗口中显示的所有对象。
EraseIcon
Icons
格式：
EraseIcon（IconID@"IconTitle"）
说明：
该函数的作用是擦除指定设计按钮中所有的显示对象。
Eval,
Character
格式：
result:
=Eval（"expression"[,decimal,separator]）
说明：
该函数的功能是计算表达式expression的值，并将该值赋给result，在该函数的expression表达式中，不能包含赋值操作符“:
=”。
EvalAssign
Character
格式：
result:
=EvalAssign（"expression"[,decimal,separator]）
说明：
该函数的功能同Eval相似，计算表达式expression的值，并将该值赋给result，在该函数的expression表达式中，可以包含赋值操作符“:
=”。
ExitRepeat
格式：
ExitRepeat
说明：
该函数在【运算】设计按钮中使用，跳出Repeat循环，执行下面的内容，如果下面没有内容，则退出该【运算】设计按钮。
Exit
Language
格式：
Exit
说明：
当Authorware在程序的执行过程中，一旦遇到该函数，在Authorware自动退出该【运算】设计按钮。
执行其它设计按钮中的内容。
例如：
ifScreenDepth>=8thenexit
Message:
="Youneedtosetyourcomputertodisplay256colors."
EXP
Math
格式：
number:
=EXP（x）
说明：
将x的自然指数的值赋给number。
EXP10
Math
格式：
number:
=EXP10（x）
说明：
将x的以10为底的指数值赋给number。
FileType
File
格式：
number:
=FileType（"filename"）
说明：
该函数的结果是返回一个数字，该数字代表文件或文件夹的不同类型：
0表示无此文件或错误；
1表示目录（文件夹）；
2表示为打包的文件（.A4P）；
3表示不包含RunA4W的打包文件（.A4R）；
4表示模板文件（.A4D）；
5表示声音文件（.AIF,.PCM,or.WAV）；
6表示数字电影文件（.MOV,.AVI,.MPG,.DIR）；
7表示PICS电影文件；
8表示用户代码（.UCDor.DLL）；
9表示文本文件（.TXT）；
10表示应用程序文件（.EXE,.COM,.BAT,.PIF）；
11表示其它文件；
12表示库文件（.A4L）；
13表示打包后的库文件（.A4E）；
Find
Charact
升级会员 