附录B:Authorware4.0的系统函数
附录C:Authorware4.0的系统函数
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)
NumList is now [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加上一个空格,它是
续表
函数
类别
使用格式及说明
Application
Platform
Authorware的源文件名。
某些XCMDs 和 DLLs需要来决定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 is 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...])
说明:该函数用来调用带有sprite Xtra功能的进程。
CallObject
General
格式:
result := CallObject("object", #method [, argument...])
说明:该函数调用一个对象的scripting Xtra句柄,我们可以使用NewObject来创建一个新的对象。
CallParentObject
General
格式:
result := CallParentObject("Xtra", #method [, argument...])
说明:调用一个具有sprite Xtra的进程。
CallSprite
General
格式:
result := CallSprite(IconID@"SpriteIconTitle", #method [, argument...])
说明:调用一个sprite进程。
Capitalize
Character
格式:
resultString := Capitalize("string" [, 1])
说明:该函数的功能是将字符串中每一个单词的首写字母转变成大写字母,Authorware自动分辨单词之间的空格。如果我们需要只转化字符串的第一个单词的第一个字母,可以使用参数“1”。
例如:
EntryText="the rain in spain"
Name := Capitalize(EntryText)
函数的结果为:"The Rain In Spain"
Name := Capitalize(EntryText, 1)
函数的结果为:"The rain in spain"
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 := "a b c"
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=0时,圆内以白色填充;
当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的范围为:(25568 49709) (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 (January 1, 1970 到 June 2, 2036);
下面的例子范围1970年1月1日所对应的月中的天数:
result := Day(25568)
返回值为:1。
DayName
Time
格式:string := DayName(numbe
说明:该函数的作用是自1900年1月1日算起,返回指定的总天数所对应的星期中的星期几。
该函数中参数number的范围为:25568 到 49709 (January 1, 1970 到 June 2, 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创建的scripting Xtra对象。
DisplayIcon
Icons
格式:DisplayIcon(IconID@"IconTitle")
说明:运行该函数,将显示IconTitle所指定的设计按钮中所有正文及图片对象显示在展示窗口中。
DisplayIconNoErase
Icons
格式:DisplayIconNoErase(IconID@"IconTitle")
说明:运行该函数,将显示IconTitle所指定的设计按钮中所有正文及图片对象显示在展示窗口中,并将该设计按钮的属性设置为同【Properties】对话框中的【Prevent Auto Erase】选项相同的属性。
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=0时,方框以白色填充;
当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=0时,椭圆内以白色填充;
当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表达式中,可以包含赋值操作符“:=”。
Exit Repeat
格式:ExitRepeat
说明:该函数在【运算】设计按钮中使用,跳出Repeat循环,执行下面的内容,如果下面没有内容,则退出该【运算】设计按钮。
函数
类别
使用格式及说明
Exit
Language
格式:Exit
说明:当Authorware在程序的执行过程中,一旦遇到该函数,在Authorware自动退出该【运算】设计按钮。执行其它设计按钮中的内容。
例如:
if ScreenDepth >= 8 then exit
Message := "You need to set your computer to display 256 colors."
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: 表示用户代码(.UCD or .DLL);
9:
表示文本文件 (.TXT);
10:
表示应用程序文件(.EXE, .COM, .BAT,
.PIF);
11:表示其它文件;
12:表示库文件(.A4L);
13:表示打包后的库文件(.A4E);
Find
Character
格式:number := Find("pattern", "string")
说明:在字符串string中查找由pattern所指定的字符串的位置,该位置的计算方法是按照字符串从左至右的方法为顺序。
例如:
result:=Find(r,carry)
result的值为3,如果在string中没有找到patten,
函数
类别
使用格式及说明
则返回值为0。
该函数的参数pattern中我们可以使用通配符
“*”:代表零个或多个字符;
“?”:代表单个字符;
使用“\”来去除字符中特殊的含义。
FindProperty
List
格式:
index :=FindProperty(propertyList, #property, [index])
说明:该函数返回具有属性的列表中,从index往后第一个具有特定属性的字符串的位置。例如:
1:propList := [#a:1, #b:2, #c:3, #a:1, #b:2, #c:3]
index := FindProperty(propList, #b)
index 的值为 2;
2:propList := [#a:1, #b:2, #c:3, #a:1, #b:2, #c:3]
index := FindProperty(propList, #b, 3)
index 的值为 5;
3:propList := [#a:1, #A:2, #A:3]
index := FindProperty(propList, #A)
index 的值为 1。
FindText
Framework
格式:number := FindText("searchString", scopeIconID, textOrKeywords, matchPattern,?
resultsInContext, convertResultsToPageIDs, searchInBackground)
说明:该函数具有强大的搜寻功能,具体内容参见函数与变量和表达式实例。
FindValue
List
格式:
index := FindValue(anyList, value [, index])
说明:该函数返回在列表中,从index往后第一个具有指定值的字符串的位置。如果没有寻找到同value相同的字符串或anylist参数不是一个列表,则该函数返回值为“0”。
例如:
1:numList := [10, 20, 30]
index := FindValue(numList, 20)
返回的数值为 2.
2:propList := [#a:10, #b:20, #c:30, #a:10, #b:20, #c:30]
index := FindValue(propList, 20, 3)
index 的值为 5。
函数
类别
使用格式及说明
FlushEventQueue
General
格式:FlushEventQueue()
说明:该函数将事件队列中等待执行的某事件取消掉。
FlushKeys
General
格式:FlushKeys()
说明:该函数的作用是忽略最终用户按下的任何键。
Fraction
Math
格式:result:=Fraction(number)
说明:该函数返回number数值中的小数点后的内容,包括小数点;例如:
Result := Fraction(12.34)
Result 的值为“.34”。
FullDate
Time
格式:string := FullDate(number)
说明:number为总天数,该函数是从1900年1月1日算起,将天数转换为具体的日期,其中number的值的范围为:25568 到 49709 (January, 1, 1970 到 June, 2, 2036)。
例如:
FullDate(25569)的值为:January, 2, 1970;该函数的返回值的格式同各计算机系统的设置有关。
GetIconProperty
General
格式:
result :=
GetIconProperty(IconID@"SpriteIconTitle", #property)
说明:该函数返回指定设计按钮SpriteIconTitle中,指定属性的值。
GetLine
Character
格式:1:resultString := GetLine("string",n)
2:resultString := GetLine("string", n , m)
3:resultString := GetLine("string", n , m, delim)
说明:
1:取出字符串中的第n行的内容;
2:取出字符串中从第n行到第m行中的内容;
3:取出字符串中从第n行到第m行中以delim指定的分界符结尾的行的内容。
GetMovieInstance
Icons
格式:
identifier:= GetMovieInstance(IconID@"MovieTitle")
说明:
该函数返回的是由MovieTitle指定的设计按钮中播放的数字化电影的数字标识。
函数
类别
使用格式及说明
GetNumber
Character
格式:number := GetNumber(n, "string")
说明:该函数返回string中第n个数字字符的数字值,如果n已经超出了string的界限或没有在第n的位置找到数字字符,则该函数返回值为“0”。
GetProperty
Platform
格式:
value := GetProperty("window", #property)
说明:该函数的作用是取得window指定的窗口属性的值,该窗口是由XCMD 或 UCD (DLL)所产生的。
GetSpriteProperty
格式:
result :=
GetSpriteProperty(IconID@"SpriteIconTitle", #property)
说明:该函数取得一个sprite属性的值。
GetTextContaining
Framework
格式:
string := GetTextContaining(n [, m, maxlen])
说明:该函数返回由FindText函数所定位的单词和该单词的上下文。
例如:
1:string := GetTextContaining(5)
该函数返回第五个相匹配的单词的内容;
2:string := GetTextContaining(5,5,20)
该实例返回第五次所匹配的单词的上下文,字符的总数为20个。
GetWord
Character
格式:resultString := GetWord(n, "string")
说明:该函数中返回第n个字符的内容,如果n的值超过string的界限,该函数返回一个空的字符串。
GoTo
Jump
格式:GoTo(IconID@"IconTitle")
说明:该函数使Authorware调整到IconTitle指定的设计按钮中。
GoToNetPage
Net
格式:GoToNetPage("URL" [, "windowType"])
说明:该函数实现Authorware在网络上的跳转;例如:
GoToNetPage("http://www.macromedia.com")
IconFirstChild
Icons
格式:
ID := IconFirstChild(IconID@"IconTitle" [, flag])
说明:该函数返回【映射】设计按钮中的第
函数
类别
使用格式及说明
一个设计按钮的ID标识,或【交互作用】设计按钮中的第一分支中反馈设计按钮的ID标识,或者【框架】结构中第一个设计按钮的ID标识,在框架结构中,有三种第一个设计按钮的方式,这三种方式由参数flag。
参数flag的含义如下:
对于【框架】设计按钮,其分支结构分三种情况:
1:当参数flag=0时,该函数返回的是页所对应的设计按钮的标题,这些页的相对位置是从左至右的顺序进行标记;
2:当参数flag=1时,该函数返回的是框架内部结构输入画面中设计按钮的标题,其相对位置是从左至右的顺序进行标记;
3:当参数flag=2时,该函数返回的是框架内部结构退出画面中设计按钮的标题,其相对位置是从左至右的顺序进行标记;
IconLastChild
Icons
格式:
ID := IconLastChild(IconID@"IconTitle" [, flag])
说明:该函数返回【映射】设计按钮中的最后一个设计按钮的ID标识,或【交互作用】设计按钮中的最后分支中反馈设计按钮的ID标识,或者【框架】结构中最后一个设计按钮的ID标识,在框架结构中,有三种最后一个设计按钮的方式,这三种方式由参数flag。
参数flag的含义如下:
对于【框架】设计按钮,其分支结构分三种情况:
1:当参数flag=0时,该函数返回的是页所对应的设计按钮的标题,这些页的相对位置是从左至右的顺序进行标记;
2:当参数flag=1时,该函数返回的是框架内部结构输入画面中设计按钮的标题,其相对位置是从左至右的顺序进行标记;
3:当参数flag=2时,该函数返回的是框架内部结构退出画面中设计按钮的标题,其相对位置是从左至右的顺序进行标记;
IconLogID
Icons
格式:number := IconLogID(n)
说明:该函数的作用是返回从当前正在执行
函数
类别
使用格式及说明
的设计按钮之前的第n个设计按钮的ID标识。当n=0时,返回当前执行的设计按钮的ID标识。
IconLogTitle
Icons
格式:1:string := IconLogTitle(n)
2:string := IconLogTitle(n, m)
说明:
1:该函数的作用是返回从当前正在执行的设计按钮之前的第n个设计按钮的标题。当n=0时,返回当前执行的设计按钮的标题。
2:该函数返回在n和m之间的所有设计按钮的标题。
IconNext
Icons
格式:ID := IconNext(IconID@"IconTitle")
说明:在【映射】设计按钮中,该函数返回当前执行的设计按钮的下一个设计按钮的ID标识,当在【交互作用】分支结构或【框架】结构中该函数包含当前执行的设计按钮右边的反馈分支设计按钮的ID标识。如果当前设计按钮为最后一个设计按钮,则该函数返回值为“0”。
IconNumChildren
Icons
格式:number:= IconNumChildren(IconID@"IconTitle" [, flag])
说明:我们使用该函数来返回【映射】设计按钮中包含的设计按钮的数目,【交互作用】设计按钮中分支路径设计按钮的数目,对应【框架】结构,返回各分支的数目,对于框架结构我们使用flag参数来设定其特指的结构的位置,具体的内容参见IconLastChild。
IconParent
Icons
格式:ID := IconParent(IconID@"IconTitle")
说明:该函数返回指定IconTitle设计按钮所属的设计按钮,对于一个IconTitle所指定的分支结构中的设计按钮,返回的是该设计按钮附属的组成分支结构的设计按钮。
IconPrev
Icons
格式:ID := IconPrev(IconID@"IconTitle")
说明:在【映射】设计按钮中,该函数返回当前执行的设计按钮的上一个设计按钮的ID标识,当在【交互作用】分支结构或【框架】结构中该函数包含当前执行的设计按钮左边的反馈分支设计按钮的ID标识。如果当前设计按钮为第一个设计按钮,则该函数返回值为“0”。
函数
类别
使用格式及说明
IconTitle
Icons
格式:string := IconTitle(IconID)
说明:该函数IconID指定的设计按钮的标题。包括对该设计按钮的注释。
IconTitleShort
Icons
格式:string := IconTitleShort(IconID)
说明:该函数返回的该函数IconID指定的设计按钮的标题。不包括对该设计按钮的注释。
IconType
Icons
格式:number:= IconType(IconID@"IconTitle")
说明:该函数返回IconTitle指定的设计按钮的类型:
0:错误的icon ID标识;1:【显示】设计按钮;2:【移位】设计按钮;3:【擦除】设计按钮4:【交互作用】设计按钮; 5:【判定】设计按钮;6:【映射】设计按钮7:【等待】设计按钮8:【运算】设计按钮;9:数字化电影; 10:【声音】设计按钮; 11:【视频】设计按钮; 12:【框架】设计按钮; 13:【定向】设计按钮;14:
Sprite Xtra 设计按钮。
IconTypeName
Icons
格式:string := IconTypeName(n)
说明:当用n用0~14中的一个数字进行替换时,该函数返回的是相应的设计按钮的描述:
1:
Display
8:
Calc
2:
Motion
9:
Movie
3:
Erase
10:
Sound
4:
Interaction 11:
Video
5:
Decision
12:
Framework
6:
Map
13:
Navigate
7:
Wait
14:
Xtra
If-Then
Language
格式:if condition then statement
或者
:if condition then
statement(s)
end if
或者:if condition then statement else statement
或者:
if condition then
statement(s)
else
statement(s)
end if
或者:if condition then
statement(s)
函数
类别
使用格式及说明
else if condition then
statement(s)
else
statement(s)
end if
说明:如果If后的条件为真,则执行statements1,否则执行statements2。
InflateRect
List
格式:InflateRect(rectangle, widthChange, heightChange)
说明:该函数改变指定矩形的尺度,widthChange为对宽度的变化值,heightChange为对矩形高度的改变值,负值为对矩形尺度的缩小,正值为对矩形尺度的增加。每一单位数值代表两个像素。
Initialize
General
格式:Initialize([variable1, variable2, ? variable10])
说明:将variable1, variable2等变量的值恢复成为初始化值。
InsertLine
Character
格式:
1:Result := InsertLine("string", n, "newstring", )
2:Result := InsertLine("string", n, "newstring", delim)
说明:
1:将newstring插入到string字符串中的第n行,并将最后结果返回给Result。
2:使用delim分隔参数时,函数在指定地插入行的同时,还要插入有delim指定的分隔符。
Intersect
List
格式:newRectangle := Intersect(rectangle1, rectangle2)
说明:从两个矩形的交叉点,创建一个新的矩形,例如:
Rectangle1 := Rect(0, 0, 20, 20)
Rectangle2 := Rect(10, 10, 30, 30)
Rectangle3 := Intersect(Rectangle1, Rectangle2)
Rectangle3 is (10, 10, 20, 20).
INT
Math
格式:number := INT(x)
说明:对数x取整,例如:
INT(3.14) 返回值 3;
INT("1a2b3c") 返回值123。
函数
类别
使用格式及说明
JumpFile
Jump
格式:JumpFile("filename", ["variable1, variable2,…,"folder"])
说明:该函数使Authorware跳转到指定的文件中。
JumpFileReturn
Jump
格式:JumpFileReturn("filename", ["variable1, variable2, …"folder"])
说明:该函数使Authorware跳转到指定的文件中,当退出该文件后,Authorware返回到原始的文件中。
JumpOut
Jump
格式:JumpOut("program", ["document"] [,"creator"]))
说明:该函数将把document指定的文件在program指定的应用程序中打开。并退出Authorware。
JumpOutReturn
Jump
格式:JumpOutReturn("program", ["document"] [,"creator"])
说明:该函数的功能同JumpOut类似,唯一的不同是该函数并不退出Authorware,仅将Authorware放到后台来运行,将programe所指定的应用程序放到前台运行。
Creator参数使用在Macintosh机上使用。
JumpPrintReturn
Jump
格式:JumpPrintReturn(["program"], "document" [, "creator"])
说明:该函数是在program中指定的应用程序中打开document并在该应用程序中打印,打印完毕后继续演示。该函数只能在【运算】设计按钮中使用,而不能在表达式或插入到正文对象中。
Creator参数使用在Macintosh机上使用。
Keywords
Framework
格式:string := Keywords(IconID@"IconTitle")
说明:返回指定设计按钮中的所有关键词,如果有多个关键词,返回时用回车符进行分隔。
LayerDisplay
Icons
格式:
LayerDisplay(LayerNumber [,IconID@"IconTitle"])
说明:该函数用来设定IconTitle设计按钮中显示对象的层数:
缺省情况下,数字化电影的层次级别为1,其它显示对象的层次为0。
函数
类别
使用格式及说明
LineCount
Character
格式:number := LineCount("string"[, delim])
说明:该函数返回字符串string的总行数,包括空白行。
LN
Math
格式:number := LN(x)
说明:该参数x取自然对数的值。
LOG10
Math
格式:number := LOG10(x)
说明:该函数返回x的以10为底的对数的值。
LowerCase
Character
格式:resultString := LowerCase("string")
说明:将字符串string的字符全部转化为小写字母后返回。
MapChars
Character
格式:string := MapChars("string", fromPlatform [, toPlatform])
说明:该函数实现字体在不同系统间的转化,其参数fromPlatform,toPlatform的含义如下:
0=current, 1=Windows, 2=Macintosh
Max
Math
格式:value := Max(anyList)
value := Max(a [, b , c, d, e, f, g, h, i, j])
说明:取列表中,或各参数中的最大值。
MediaPause
General
格式:MediaPause(IconID@"IconTitle", pause)
说明:该函数的作用是暂停或继续播放在指定设计按钮中的数字化电影,参数pause为TRUE时,暂停播放,参数pause为FALSE时,Authorware将继续播放。
MediaPlay
General
格式:MediaPlay(IconID@"IconTitle")
说明:
该函数是使指定设计按钮中的数字化电影开始播放。
MediaSeek
General
格式:MediaSeek(IconID@"IconTitle", position)
说明:
该函数的作用是设置指定设计按钮中数字化电影的帧数,使Authorware直接定位该帧的图像。
Min
Math
格式:value := Min(anyList)
value := Min(a [, b, c, d, e, f, g, h, i, j])
说明:返回列表中,或各参数中的最大值。
MOD
Math
格式:number := MOD(x, y)
说明:该函数返回x/y的余数。
例如:
将24小时制的时间转化为12小时制的时间:
Hours := Mod(2300/100,12)
函数
类别
使用格式及说明
Month
Time
格式:number := Month(number)
说明:number为距离1900年1月1日的天数,该函数返回的是从该天算起number天数在当前的月的数值。
Number参数的范围为25568到 49709 (January 1, 1970 为 June 2, 2036)
MonthName
Time
格式:string := MonthName(number)
说明:number为距离1900年1月1日的天数,该函数返回的是从该天算起number天数在当前的月的名称。
Number参数的范围为25568到 49709 (January 1, 1970 为 June 2, 2036)
MoveWindow
General
格式:MoveWindow(top, left)
说明:该函数只能在【运算】设计按钮中使用,不能作为装饰或在表达式中使用,该函数的作用是将展示窗口遇到到指定的位置。
NetDownload
Net
格式:string := NetDownload("URL")
说明:该函数将指定URL中的文件下载到本地硬盘上,并返回在下载文件在本地硬盘上的路径和文件名。
NetPreload
Net
格式:NetPreload(IconID@"IconTitle")
说明:该函数的作用是使用Authorwaed Shockwave插件将指定设计按钮中的内容,上载到网络上,准备以后的使用。
NewObject
General
格式:object := NewObject("Xtra" [, arguments...])
说明:该函数创建一个新的scripting Xtra并通过参数的设置来调用一个实例启动。
Next Repeat
Language
格式:Next Repeat
说明:使用该函数在循环控制中,省略后面的内容,从头重新开始新的一个循环。
Number
Math
格式:number :