常用系统函数介绍.doc

常用系统函数介绍1AppendExtFile语法：Number := AppendExtFile (“Filename”, “String”)说明：该函数是将字符串“String”添加到指定文本文件Filename的尾部。如果指定的文本文件不存在，则该函数会创建该文件，然后再将字符串“String”添加到该文件的尾部。如果没有为指定文件指定路径，Authorware会使用变量FileLocation作为路径。当使用AppendExtFile函数时，Authorware会更新两个系统变量：IOStatus和IOMessage，并且返回IOStatus的值。如果无错误，则IOStatus为0，IOMessage为空。如果有错误发生，操作系统将错误号赋给IOStatus。只要IOStatus不为0，表明出错，IOMessage中包含的将是出错信息。需要注意的是，AppendExtFile函数是将文本添加到一个文件中，使用WriteExtFile函数是将文本覆盖文件的内容，而使用ReadExtFile函数则可以度曲文件的内容。当Authorware的Web Player运行于非信任模式下，该函数无效。示例：AppendExtFile (RecordsLocation “DATA.TXT”, NewUser)将变量NewUser中的内容添加到文件DATA.TXT尾部。相关变量：IOMessage，FileLocation，RecordsLocation相关函数：ReadExtFile，WriteExtFile2DeleteLine语法：Result := DeleteLine (“String”, n , m, delim)说明：该函数是将字符串“String”中的第n行删除后，将剩余部分赋值给变量Result。如果也定义了m值，则该函数是将字符串“String”中的第n行到第m行全部删除，然后将剩余部分赋值给变量Result。若同时也定义了delim，则将各行的分隔符设定为delim指定的值，如Tab符。系统缺省的行分隔符为回车符（Return）。示例：设Lines := “Macromedia Authorware” Return “is a” Return “media software.” Return。Result := DeleteLine (Lines, 2)。Result的值变为Result = “Macromedia Authorwarermedia softwarer”。设Lines := “Macromedia Authorware” Tab “is a” Tab “media” Tab “ software.” Tab。Result := DeleteLine (Lines, 2, 3, Tab)。Result的值变为Result = “Macromedia Authorwaret softwaret”。3DisplayIcon语法：DisplayIcon (IconID“IconTitle”)说明：该函数是用于显示图标标题为“IconTitle”的图标的内容。如果该图标已经被显示了，则会更新所有已显示的变量。该函数只能用到【计算】图标中。示例：DisplayIcon (IconID“背景”)显示标题为“背景”图标的内容。4EraseIcon语法：EraseIcon (IconID“IconTitle”)说明：该函数是用于擦除图标标题为“IconTitle”的图标的内容。该函数只能用到【计算】图标中。示例：EraseIcon (IconID“背景”)擦除标题为“背景”图标的内容。5Exit Repeat语法：Exit Repeat说明：该函数用于退出循环体而执行下面图标的内容。可以将该函数放在循环体中的任意位置。6Find语法：Number := Find (“Pattern”, “String”)说明：该函数用于从指定的字符串“String”中查找子字符串“Pattern”的位置。如果查找到，则返回第一个匹配的字符位置；如果没有找到则返回0。该函数是区分大小写的。如果不想区分大小写，可以首先使用函数LowerCase或UpperCase将字符串全部变成小写或大写。在使用Find函数时，可以使用一些特殊符号来扩大查找范围：*：代表0个或多个字符?：代表任何一个字符：查找特殊符号。如：使用“?”表示查找字符“?”。注意：Authorware将每一个空格和标点符号都当作是一个字符。示例：Location := Find (“media”, “Macromedia Authorware”)返回Location=6。7GetLine语法：Result := GetLine (“String”, n , m, delim)说明：该函数是将字符串“String”中的第n行赋值给变量Result。如果也定义了m值，则该函数是将字符串“String”中的第n行到第m行全部赋值给变量Result。若同时也定义了delim，则将各行的分隔符设定为delim指定的值，如Tab符。系统缺省的行分隔符为回车符（Return）。示例：设Lines := “Macromedia Authorware” Return “is a” Return “media software.” Return。Result := GetLine (Lines, 2)。Result的值变为Result = “is a”。设Lines := “Macromedia Authorware” Tab “is a” Tab “media” Tab “ software.” Tab。Result := GetLine (Lines, 2, 3, Tab)。Result的值变为Result = “is atmedia”。8GoTo语法：GoTo (IconID“IconTitle”)说明：该函数是使执行流程跳转到“IconTitle”指定的图标处运行。示例：GoTo (IconID“背景”)程序跳转到“背景”图标处运行。9IconID语法：Number := IconID (“IconTitle”)说明：该函数返回由“IconTitle”指定的图标的ID号。10If-Then语法：If 条件 then 语句或 If 条件 then 语句 end if或 If 条件 then 语句1 else 语句2或 If 条件 then 语句1 else 语句2 end if或 If 条件1 then 语句1 else If 条件2 then 语句2 else 语句3 end if示例：If Flags = True then GoTo (IconID“风景1”)else GoTo (IconID“风景2”)end if11InsertLine语法：Result := InsertLine (“String”, n , “NewString”, delim)说明：该函数是将字符串“NewString”插入到字符串“String”中的第n行位置，然后将结果返回给变量Result。如果n=0，则将“NewString”插入到字符串“String”的第1行前面；如果n的值大于了字符串“String”的总行数，则将“NewString”插入到字符串“String”的末尾和第n行之间。若同时也定义了delim，则将各行的分隔符设定为delim指定的值，如Tab符。系统缺省的行分隔符为回车符（Return）。示例：设 String1 := “Monday” Return “Wednesday” Return String2 := “Tuesday” String3 := InsertLine (String1, 2, String2)返回String3 = “MondayrTuesdayrWednesday”12JumpFile和JumpFileReturn语法：JumpFile (“FileName”, “Variable1, Variable2, ”, “Folder”) JumpFileReturn (“FileName”, “Variable1, Variable2, ”, “Folder”)说明：函数JumpFile是使执行流程跳转到“FileName”指定的文件继续运行。函数JumpFileReturn则是使执行流程跳转到“FileName”指定的文件继续运行，运行该文件后，返回到原处继续执行初始文件。使用这两个函数，Authorware会自动搜索后缀名为a5p的文件，故指定文件时无需加入扩展名。同样，runa5w（打包文件）和runa5m文件自动搜索以exe或a5r为后缀的文件。可以通过Variable参数在文件间传送参数，但必须保证两文件中有相同的变量。若传送多个参数，则参数间用分号分隔，且参数项需用引号引起来。还可使用*号代表具有相同子串的变量或所有变量。若定义了Folder参数，则系统变量RecordLocation就会从缺省值变为定义好的Folder值，且这是惟一改变系统变量RecordLocation值的方法。注意：如果在Authorware的Web Player运行状态下，还可以使用网络地址URL作为参数。示例：JumpFile (“history”, “subjects”)JumpFileReturn (“history”, “”, FileLocation “User Records”)13JumpOut或JumpOutReturn语法：JumpOut (“Program” , “Document”) JumpOutReturn (“Program” , “Document”)说明：函数JumpOut是用参数“Program”指定的应用程序打开文件“Document”，同时退出Authorware；函数JumpOutReturn是用参数“Program”指定的应用程序打开文件“Document”，只是并不退出Authorware。这两个函数只能用在【计算】图标中。示例：JumpOutReturn (“Natepad.exe”, “data.txt”)使用写字伴打开文本文件data.txt。JumpOutReturn (“ ”, “data.txt”)使用系统默认的文本编辑程序打开文本文件data.txt。14MoveWindow语法：MoveWindow (Top, Left)说明：该函数是将当前窗口的左上角移动到Top，Left指定的位置。该函数只能使用到【计算】图标中。注意：要使当前窗口定位在某一位置，必须在保存和打包文件前进行定位。示例：MoveWindow (0, 0)将当前窗口移到展示窗口的左上角。相关变量：WindowHeight，WindowWidth，WindowTop，WindowLeft15Next Repeat语法：Next Repeat说明：该函数是跳过循环体中剩下未执行的命令，直接跳到下一次循环。可以将该函数放在循环体中的任意位置。16Quit语法：Quit (Option)说明：该函数是退出当前文件。参数Option有以下取值：0：退出当前Authorware文件。如果该文件是从其他程序调用的，则返回到调用它的程序中，继续执行原来程序。当用户直接输入Quit ( )，Authorware默认参数值为0。1：退出当前Authorware文件。2：退出当前Authorware文件并重新启动计算机。如果操作系统为Win31，则退回到Dos状态下。3：退出当前Authorware文件，如果操作系统为Win95、Win98、或WinNT时，则关闭计算机；如果操作系统为Win31，则退出Authorware程序并显示出程序管理器。17Random语法：Random (Min, Max, Units)说明：该函数返回一个介于Min和Max之间，并且是Units的倍数的数。示例：Num := Random (1, 10, 2)返回1和10之间的数，并且该数是2的倍数（取值可能为2，4，6，8，10），并将该随机数赋给变量Num。Value := Random (1, 5, .5)返回1和5之间的数，并且该数是0.5的倍数（取值可能为1，1.5，2，2.5，3,），并将该随机数赋给变量Value。18ReadExtFile语法：String := ReadExtFile (“Filename”)说明：该函数是将文件Filename的内容赋给变量String。若指定网络地址URL，则必须为绝对地址，如：http:/或file:/。该函数只能用到【计算】图标中。使用ReadExtFile函数时，Authorware会将相关信息保存到系统变量IOStatus和IOMessage中，并且返回IOStatus的值。如果无错误，则IOStatus为0，IOMessage为空。如果有错误发生，操作系统将错误号赋给IOStatus。只要IOStatus不为0，表明出错，IOMessage中包含的将是出错信息。当Authorware的Web Player运行于非信任模式下，若文件为本地文件则该函数无效。示例：FileString := ReadExtFile (“D:Data.TXT”)将D盘下的文本文件Data.txt中的内容赋给变量FileString。相关变量：IOStatus，IOMessage相关函数：AppendExtFile，WriteExtFile19Repeat While语法：Repeat While 条件 语句 End Repeat说明：该函数建立一个循环。当判断条件为True时，就执行下面的语句；每开始一次循环，都要判断一下判断条件，直到判断条件为False时才退出循环。示例：i :=0Repeat While i 10 i := i + 1End Repeat20Repeat With语法：Repeat With Counter := Start down to Finish 语句 End Repeat说明：该函数建立一个循环。其循环次数Counter定义为一个范围，从小到大时使用函数to，范围为从Start到Finish（此时StartFinish），（此时Start=51。示例：SetCursor (6)将鼠标光标类型设置成手形。25ShowCursor语法：ShowCursor (Display)说明：该函数是