Authorware常用系统函数说明速查.docx
《Authorware常用系统函数说明速查.docx》由会员分享,可在线阅读,更多相关《Authorware常用系统函数说明速查.docx(26页珍藏版)》请在冰点文库上搜索。
![Authorware常用系统函数说明速查.docx](https://file1.bingdoc.com/fileroot1/2023-5/1/03485420-4c46-457e-b7a5-381392f33e75/03485420-4c46-457e-b7a5-381392f33e751.gif)
Authorware常用系统函数说明速查
Authorware常用系统函数说明速查
ABS类别:
Math语法:
number:
=ABS(x)说明:
返回x的绝对值。
ACOS类别:
Math语法:
number:
=ACOS(x)说明:
返回x的反余弦值(-1≤x≤1)
AddLinear类别:
List语法:
AddLinear(linearList,value,index)说明:
将给定的数值插入到线性表的索引位置。
AddProperty类别:
List语法:
AddProperty(propertyList,#property,value,index)说明:
将属性及属性值插入到属性表中去。
AppendExtFile类别:
File语法:
AppendExtFile(“filename”,“string”)说明:
该函数的作用与writeexit函数类似,它是将字符串string直接追加到文本文件filename的结尾,而AppendExtFile函数则是用字符串string覆盖掉filename的文件内容。
当所指定的filename文件不存在时,Authorware会直接生成这样一个文件,并将string内容加入。
因此,在这种情况下二者作用结构完全相同。
Application 类别:
Platform语法:
string:
=Application()说明:
该函数的返回值是COA加上一个空格(“COA”),COA是Courseof Action的缩写,它是Authorware的源文件名。
Array类别:
List语法:
myarray:
=Array(value,dim1,dim2,dim3,...dim10)说明:
创建一个填充有value值的线性表。
ArrayGet类别:
Math语法:
result:
=ArrayGet(n)说明:
读取系统数组中的第n个元素,并将它返回给变量result,返回值可以是字符串也可以是数字。
ArraySet类别:
Math语法:
ArraySet(n,value)说明:
给系统数组中的第n个元素设置value值,value可以是字符串或数字。
ASIN类别:
Math语法:
number:
=ASIN(x)说明:
返回x的反正弦(-1<=x<=1)。
ATAN 类别:
Math语法:
number:
=ATAN(x)说明:
返回x的反正切。
Average 类别:
Math语法:
value:
=Average(anyList)value:
=average(a[,b,c,d,e,f,h,I,j])说明:
返回线性表一级元素的平均值或多个参数的平均值,参数值最多可定10个。
Beep 类别:
General语法:
Beep()说明:
使系统喇叭发声。
Box类别:
graphics语法:
Box(pensize,x1,y1,x2,y2)说明:
用pensize指定的线宽在屏幕上从(x1,y1)点画一个方框,其中(x1,y1)是方框左上角的坐标值,(x2,y2)是方框右下角的坐标值。
当pensize<0时,该方框将以黑色填充;当pensize=0时,该方框将以白色填充;当pensize>0时,将以pensize指定值的像素点个数绘制框线。
CallIcon类别:
General语法:
result:
=CallIcon(@“SpriteIconTitle”,#method,argument...)说明:
调用与SpriteXtra有效连接的方案。
CallObject类别:
General语法:
result:
=CallObject(object,#method,arguments...)说明:
调用一个对象的scriptingXtra句柄方案或它的双亲方案。
函数newobject将创建一个新对象。
CallParentObject 类别:
General语法:
result:
=CallParentObject(“Xtra”,#method,arguments...)说明:
为Xtra调用一个scriptingXtra句柄双亲方案。
CallSprite类别:
General语法:
result:
=CallSprite(@“SpriteIconTitle”,#method,argument...)说明:
调用一个精灵的方案。
Capitalize类别:
Character语法:
resultString:
=Capitalize(“string”,1)说明:
将string指定的字符串中每个词的第一个字母大写后返回给变量resultString,如果带上参数1,表示只大写化第一个词的第一个字母。
Catalog 类别:
File语法:
string:
=Catalog(“folder”,“F”|“D”)说明:
根据folder(目录)参数所指定的位置,flag所指定的类型,返回该路径下符合flag所指定的类型的所有文件或目录的字符串列表,每行一个文件或目录项。
Flag取值F表示只返回文件项;flag取值D表示只返回目录项。
Folder不能为空,目录名之间用反斜杠“\\”相隔。
Char类别:
Character语法:
string:
=Char(key)说明:
返回指定Key值(ASCII)码值)所对应的字符、数字、符号等。
例如Char(100)的值为“d”。
CharCount类别:
Chararcter语法:
number:
=CharCount(“string”)说明:
返回参数串string的字符个数(包括空格和特殊符号等)。
ChildIDToNum类别:
Icons语法:
number:
=ChildIDToNum(IconID@ParentTitle,@ChildTitle,flag)说明:
返回参数ChildTitle(孩子图标名)在ParentTitle(双亲图标名,一般为组图标、分支图标、框架图标、交互图标)下的位置序号(从顶至下或由左至右排序),如果ChildTitle不在ParentTitle下,函数返回值为0。
参数flag要求函数返回ChildTitle是否在ParentTitle结构图标之下或其入口、出口的位置,它有如下对应值:
l0——缺省值,返回ChildTitle在框架图标ParentTitlee的第几页下。
l1——返回ChildTitle在框架图标ParentTitle的入口处的位置(由上而下排)。
l2——时,返回ChildTitle在框架图标ParentTitle的出口处的位置(由上而下排)。
ChildNumToID类别:
Icons语法:
ID:
=ChildNumToID(IconID@ParentID,n,flag)说明:
返回指定Parent(双亲图标),一般为组图标、分支图标、框架图标)中相对位置为n处的图标ID号,参数flag的含义与上面所述相同。
Circle类别:
Graphics语法:
Circle(pensize,x1,y1,x2,y2)说明:
在给定矩形限制框内画一个圆,该矩形左上角的坐标值(x1,y1),矩形右下角的坐标值是(x2,y2)。
当Pinsize<0时,该矩形以黑色填充;当Pensize=0时,该矩形将以白色填充;当Pensize>0时,圆周的线条宽度将等于Pensize指定的像素点值,中间不填充。
CloseWindow类别:
Platform语法:
CloseWindow(“window”)说明:
关闭由window所指定的窗口,该窗口是由UCD或XMD所生成的。
Code类别:
Character语法:
number:
=Code(“character”)说明:
返回与Character相对应的ASCII码值,如Code(Esc)的返回值为27。
CopyList类别:
List语法:
newList:
=CopyList(anyList)说明:
返回列表(list)的一个完整拷贝(包括子列表)。
COS类别:
Math语法:
number:
=COS(angle)说明:
返回指定角度angle的余弦值。
CreateFolder 类别:
File语法:
number:
=CreateFolder(“folder”)说明:
创建一个由folder指定名称的目录(文件夹),缺省情况下,该目录建在当前数据记录所在的目录下。
文件运行以后,系统变量“IOStatus”和“IOMessage”将返回该函数被操作后的具体信息。
Date类别:
Time语法:
string:
=Date(number)说明:
函数中的参数number用于表示总的天数,然后该函数将把总的天数转换成当前计算机系统的简短的日期字符串。
转换的方法是从1970年1月1日算起,number的有效取值范围是25569~49709(1970年1月2日至2036年2月5日)。
DateToNum类别:
Time语法:
number:
=DateToNum(day,month,year)说明:
正好与函数Date(number)的操作相反,它是将输入的日期和1970年1月1日的时间差转换成总的天数值。
参数day表示日期,有效值范围1≤day≤31;参数month表示用份,有效值范围1≤mo≤12;参数yearr表示年份,有效值范围1970≤yr≤2025。
Day类别:
Time语法:
number:
=Day(number)说明:
从1970年1月1日算起,返回指定的总天数所对应的日值。
如:
Day(255698)返回值即为2。
DayName类别:
Time语法:
result:
=DayName(number)说明:
该函数的作用与Day()相同。
它返回的是指定的总天数的星期几名。
如:
Dayname(25569)返回值将为“Friday”。
DeleteAtIndex 类别:
List语法:
DeleteAtIndex(anyList,index)说明:
删除表中指定索引号处的元素。
如果index超出了表的长度范围或参数anyList指定的不是一个表,那么此函数的操作将无效。
DeleteAtProperty 类别:
List语法:
DeleteAtProperty(propList,#property)说明:
从属性表中删除具有指定属性的第一个元素。
如果属性名没有被找到或参数propList指定的不是一个属性表,那么此函数的操作将无效。
这里需强调一点,属性表中的符号大小写并不敏感。
DeleteFile类别:
File语法:
DeleteFile(“filename”)说明:
删除由Filename指定的目录或文件。
当删除一个文件时,最好带上它的扩展名,以免发生误删除。
DeleteLine类别:
Character语法:
result:
=DeleteLine(“string”,n,m,delim)说明:
返回参数字符串string的第n行删除后的串值;或返回删除参数字符串的第n行到第m行后的串值;还可以指定行分隔符delim(例如空格),缺省状态下,“回车”作为行分隔符。
DeleteObject 类别:
General语法:
DeleteObject(object)说明:
删除由函数NewObject创建的scriptingXtra对象的实例。
DisplayIcon 类别:
Icons语法:
DisplayIcon(IconID@“IconTitle”)说明:
显示指定图标的内容。
DisplayIconNoErase类别:
Icons语法:
DisplayIconNoErase(IconID@“IconTitle”)说明:
显示特定图标的内容,并象选上了该图标的属性对话框中的“防止自动擦除(PreventAutomaticErase)”一样。
DrawBox类别:
Graphics语法:
DrawBox(pensize,x1,y1,x2,y2)说明:
该函数允许用户在屏幕上按下鼠标并自由拖动画出一个矩形,如果想限制用户作图的范围,可由参数x1,y1,x2,y2来指定。
其中线宽为Pensize,如果不用函数SetFrame和SetFill来设置矩形框和填充颜色,则矩形框的颜色为黑色,填充为透明色,若参数Pensize值为-1,则画实心矩形。
DrawCircle 类别:
Graphics语法:
DrawCircle(pensize,x1,y1,x2,y2)说明:
用Pensie指定的线条宽度绘制一个椭圆,若希望限定画圆区域,加上参数不清x1,y1,x2,y2。
除非用系统函数SetFrame和SetFill设置线的颜色和内部填充颜色,一般线为黑色,内部透明,pensize取值-1时画的是实心圆。
DrawLine类别:
Graphics语法:
DrawLine(pensize,x1,y1,x2,y2)说明:
用Pensie指定的线条宽度绘制一条直线,若希望限定画线区域,加上参数x1,y1,x2,y2。
除非用系统函数SetFrame和SetFill设置线的颜色,一般线为黑色,pensize取值-1时画的是黑色线。
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:
=EvalAssign(“(x:
=30)+y”).
EXP类别:
Math语法:
number:
=EXP(x)说明:
将ex的值赋给number。
EXP10类别:
Math语法:
number:
=EXP10(x)说明:
将10x的值赋给number.
FileType类别:
File语法:
result:
=FileType(“filename”)说明:
返回标识你所指定的文件或目录的文件类型的值,有些文件型由扩展名(由三个字母组成)所标识。
Find类别:
Character语法:
number:
=Find(“pattern”,“string”)说明:
在指定的串“string”里查找“pattern”指定的字符串,并返回第一次匹配该串的第一个字符的位置,如果pattern指定的字符串没有被找到,则该函数返回0值。
Findproperty 类别:
List语法:
index:
=FindProperty(propList,#property,index)说明:
返回与指定属性匹配的第一个元素的索引号,如果指定参数index。
则返回从此索引号开始与属性匹配的第一个元素的索引号,当表中不存在指定的属性或propList不是一个属性表时,该函数返回值为0。
FindText类别:
Framewor语法:
number:
=FindText(“searchString”,scopeIconID,textOrKeywords,matchPattern,resultsInContext,convertResultsToPageIDs,searchInBackground)说明:
FindValue类别:
List语法:
index:
=FindValue(anyList,value,index)说明:
返回与指定值匹配的第一个元素的索引号,如果指定参数index,则返回从此索引号开始与其匹配的第一个元素的索引号。
当表中的元素没有值为value或参数anylist指定的不是一个表时,如果是线性表,则返回0;如果是属性表,则返回空值。
FlushEventQueue 类别:
General语法:
FlushEventQueue()说明:
将从事件列表中清除所有尚未处理的事件。
FlushKeys类别:
General语法:
FlushKeys()说明:
将清除在这之前尚未处理的用户的所有键盘输入,但不清除系统的等效键盘输入(如函数PressKey(“A”))
Fraction 类别:
Math语法:
result:
=Fraction(value)说明:
返回参数数值的小数部分。
FullDate类别:
Time语法:
string:
=FullDate(number)说明:
参数number表示天数,Fulldate()函数将从1970年1月1日算起,将天数转化为具体的日期,举例来说,Fulldate(4)的返回值将为“Jan.5th,1990”。
GetIconProperty 类别:
General语法:
result:
=GetIconProperty(IconID@“IconTitle”,#property)说明:
获取精灵图标的指定属性值,如果该图标不存在,则创建一个该图标的实例。
GetLine 类别:
Character语法:
resultString:
=GetLine(“string”,n,m,delim)说明:
取出参数字符串string的第n行,如果指定参数m,则返回从第m行到第n行的所有字符串。
还可通过参数delim来设定行分隔符,缺省情况下,行分隔符为回车符“Return”,如果使用了该参数,也必须使用第三个参数。
GetMovieInstance 类别:
Icons语法:
String:
=GetMovieInstance(IconID@“MovieTitle”)说明:
返回一个Authorware内部的QuickTime或AVI动画的实例,以供外部UCMD或UCD来按系统没提供的方式控制它,如XCMD可改变QuickTime动画的语言、磁道等信息方式
GetNumber 类别:
Character语法:
result:
=GetNumber(n,“string”)说明:
返回参数串string的第n个数,如果该串中没有这么多数字或没有数字,函数返回0值。
GetProperty类别:
Platform语法:
value:
=GetProperty(“window”,#property)说明:
获得特定窗口的属性值,其中window所指的窗口是由XCMD或UCD所生成的。
GetSpriteProperty 类别:
General语法:
result:
=GetSpriteProperty(@“SpriteIconTitle”,#property)说明:
返回指定精灵的属性值。
GetTextContaining类别:
Frame语法:
string:
=GetTextContaining(n,m,maxlen)说明:
返回由Findtext()函数查找到的第n个(到第m个)匹配的词;参数maxlen表示返回匹配串所在的环境字符串的最大长度,包括匹配词本身,它要有效,必须保证函数FindText的参数resultsInContext被设为真以返回匹配的内容。
GetWord类别:
Character语法:
result:
=GetWord(n,“string”)说明:
返回参数字符串string中的第n个词,如果n的值超出字符串string中的总词数,则返回“”(空字符串)。
GoTo类别:
Jump语法:
GoTo(IconID@“IconTitle”)说明:
跳转到函数所指定的图标处继续程序的执行。
GoToNetPage类别:
Network语法:
GoToNetPage(“URL”,“windowType”)说明:
打开某指定的网址。
l当参数WindowType设置为“-self”或省略时,在当前网络浏览器中显示指定的网页并退出当前的shockwave程序。
l当参数windowType设置为“-blank”时,保留当前Authorware文件打开的浏览窗口并打开一个新的浏览窗口显示URL。
IconFirstChild类别:
Icons语法:
ID:
=IconFirstChild(IconID@“IconTitle”,flag)说明:
返回指定组图标、交互图标或框架图标中相对位置为1的图标的ID标识。
Flag参数只对flag=1指的框架图标有效:
lflag=0指的是相对位置为1的页。
lflag=1指的是框架窗口中的输入画面中相对位置为1的图标。
lflag=2指的是框架窗中的退出画面中相对位置为1的图标。
IconLastChild类别:
Icons语法:
ID:
=IconLastChild(IconID@“IconTitle”,flag)说明:
该函数的作用是与IconFirstChild()函数作用相似,它返回的是指定图标中相对位置排在最后的那个图标的ID标识。
IconLogID类别:
Graphics语法:
number:
=IconLogID(n)说明:
返回当前正在执行的图标之前的第n个图标的ID标识。
当n=0时,返回当前图标的ID标识。
IconLogIDTitle类别:
Graphics语法:
string:
=IconLogTitle(n,m)说明:
返回当前正在执行的图标之前的第n个图标的名称。
当n=0时,返回当前执行的图标的名称;当定义第二个参数m后,Authorware将返回落在n和m之间的所有图标的名称。
IconNext类别:
Graphics语法:
ID:
=IconNext(IconID@“IconTitle”)说明:
在一个组图标中,该函数返回的是指定图标的下一个图标的ID标识。
l如果指定图标是包含在组图标中的最后一个图标,则返回值是0。
l当用在一个框架结构中时,该函数则返回指定页的下一页图标的ID标识。
l如果指定页是该框架结构的最后一页架结构的最后一页则返回值为0。
IconNumChildren 类别:
Graphics语法:
number:
=IconNumChildren(IconID@“IconTitle”,flag)说明:
返回指定图标(组图标、交互图标或框架图标)中包含的图标总数。
参数flag只对框架图标有效:
lflag=0返回的是指定框架结构中的总页数。
lflag=1返回的是框架窗口中的输入画面的总图标数。
lflag=2指的是框架窗口中的退出画面的总图标数。
IconParent类别:
Graphics语法:
ID:
=IconParent(IconID@“IconTitle”)说明:
在Authorware中,有时也将组图标、交互图标或框架图称为母图标,而把包含于它们中的图标称为子图标。
该函数的作用是返回指定子图标的母图标的ID标识。
IconPrev类别:
Graphics语法:
ID:
=IconPrev(IconID@“IconTitle”)说明:
该函数的作用与IconNext()函数的作用类似,它返回的是指定子图标之前的图标ID标识,当指定图标之前没有任何子图标时,返回值为0。
IconTitle类别:
Graphics语法:
string:
=IconTitle(IconID)说明:
当指定一个图标的ID标识时,该函数返回的是该ID标识所对应的图标名称。
IconTitleShort类别:
Graphic