Authorware 60系统函数一览表.docx

1、Authorware 60系统函数一览表Authorware 6.0系统函数一览表使用系统函数，一方面可以进行数据处理，另一方面可以控制Authorware执行特定的操作，完成不同的功能。Authorware6.0 提供了大量系统函数，大大增强了对程序流程的控制能力。Authorware 6.0比5.x版本新增了16个函数，详见表C-1。表C-1 Authorware 6.0新增系统函数及其说明函数说明GetExternalMedia返回在代码或库中使用的外部的媒体文件的完整的列表。GetFunctionList根据指定的类别（category）返回关于函数的信息的属性列表。GetLibrar

2、yInfo返回当前的程序文件与相联系的所有的库的线性列表。GetPasteHand返回最靠近粘贴指针的图标的ID。GetSelectedIcons返回描述在当前组图标中选中的图标的线性列表。GetVariableList返回指定的类别中的变量的信息的属性列表。GroupIcons把选择的图标放到一个组图标中。OpenFile打开指定的程序文件。OpenLibrary打开指定内容的库文件。PackageFile把当前打开的程序文件打包。PackageLibrary打包指定的库文件。SaveLibrary保存指定内容的库文件。SetHotObject将当前使用的物体设为热物响应。SetMotion

3、Object将当前使用的物体设为移动图标使用的物体。SetTargetObject将当前使用的物体设为目标响应。UngroupIcons把选中的组图标的组取消。Authorware 6.0提供的系统函数共358个，分为17个类别，下面分类说明。表C-2 Character字符管理类函数函数说明Capitalize格式： resultString := Capitalize(string , 1)说明：将指定字符串“string”中每一个单词的首字母变为大写返回给变量resultString。，Authorware通过字符间的空格来识别单词。若只想转化第一个单词的首字母，则加上参数“1”。Cha

4、r格式： string := Char(key)说明：取Key所指定的ASC码或键对应的字符、数字、符号、或键名。CharCount格式： number := CharCount(string)说明： 返回字符串中的字符个数，包括空格和特殊字符Code格式： number := Code(character)说明：返回字符、数字、符号、或键名对应的ASCII码，若是键名，则不用引号。可用此函数查找文件中用作分隔符的字符。非ASCII码的数字代码在Windows和Macintosh平台上可能不同。DeleteLine格式：resultString := DeleteLine(string, n

5、, m , delim)说明：从字符串string中删除第n行后，将剩下的内容返回。若定义了m值，则删除第n行到第m行。若定义了delim参数，则将各行的分隔符设为delim 指定值。缺省各行间用回车符（Return）作为间隔符。Eval,格式： result := Eval(expression , decimal, separator)说明：计算表达式“expression”的值，将结果赋给变量result。此函数能解释包括数学表达式在内的各种字符串。不能用此函数计算包含:=操作符的表达式，但可以使用EvalAssign函数将这一操作的结果赋给一个变量（可包含:=操作符）。 Decimal

6、参数确定表达式中的哪一个字符用作小数点。Separator参数确定表达式中的哪一个字符用作分隔符。操作系统的定位设置决定了缺省的小数点和分隔符。需要确定表达式在任何系统上皆能正确运行。使用这两个系统函数发生的语法错误信息保存在系统变量EvalStatus和EvalMessage中。EvalAssign格式： result := EvalAssign(expression , decimal, separator)说明： 同系统函数Eval，只是可以使用:=操作符。Find格式： number := Find(pattern, string)说明：查找并返回由pattern指定的字符在字符串st

7、ring中的第一个位置，如果没有找到则返回0。此函数区分大小写，故使用前可用LowerCase或UpperCase函数转化字符串。可以使用特殊字符来扩大查找范围，如：“*”：代表零个或多个字符；“？”：代表任何单一字符；“”： 查找特殊字符果，和特殊字符合用。如：“?”指字符“?”。GetLine格式：resultString := GetLine(string, n , m, delim)说明：将字符串第n行赋给变量resultString，定义参数m，则返回第nm行。缺省行与行之间缺省用回车符间隔。用delim参数来更改间隔符的设定，如TAB符等。注意：使用delim参数则必须使用m参数，

8、即使只获得一行。GetNumber格式： number := GetNumber(n, string)说明：返回字符串中第n个数字值给变量number，若没有找到，则返回0。GetWord格式： resultString := GetWord(n, string)说明：返回字符串中第n个单词给变量resultString，若没有找到，则返回空串（null）。InsertLine格式：resultString := InsertLine(string, n, newString, delim)说明： 将newstring插入到字符串string中的位置，并将结果返回。若n=0，则将newstri

9、ng插到第一行前，若n的值大于字符串的总行数，则将newstring插到末尾和第n行之间。缺省时行与行之间用回车符（Return）隔开，可通过设定delim参数将用delim参数值将分隔符更改，如为：TAB符等。LineCount格式： number := LineCount(string, delim)说明：返回字符串string的总行数，包括空白行。缺省时行与行之间用回车符（Return）隔开，可通过设定delim参数将用delim参数值将分隔符更改，如为：TAB符等。LowerCase格式： resultString := LowerCase(string)说明：将字符串“string”

10、所有大写字母转化为小写后返回。MapChars格式： string := MapChars(string, fromPlatform , toPlatform)说明：将字符串string从fromPlatform平台映射到toPlatform平台。平台Platform的值为：0 当前平台1 Windows平台2 Macintosh平台NumCount格式： number := NumCount(string)说明：返回在字符串中数字的个数，Authorware遇到一个空格或非数字字符则认为一个数字终止。Authorware自动将用户最后一个文本交互中的总数字数存在系统变量number中。Red

11、uce格式： resultString := Reduce(set, string)说明：按所指定的字符或字符串，将string相应的字符或字符串取出，使set中设置的字符串里的每个字符在取出后的字符串中均相邻，以使字符串string得到简化。RepeatString格式： resultString := RepeatString(string, n)说明：将字符串string重复n次后赋给变量resultString。Replace格式： resultString := Replace(pattern,replacer,string)说明：将字符串string中的子串pattern 用指定字

12、符串replacer替换，然后返回。可以使用特殊字符来扩大查找范围，如：“*”：代表零个或多个字符；“？”：代表任何单一字符；“”： 查找特殊字符果，和特殊字符合用。如：“?”指字符“?”。ReplaceLine格式： Result := ReplaceLine(string, n, newstring, delim)说明：返回用字符串newstring替换字符串string中的第n行子串的结果。ReplaceString格式： resultString := ReplaceString(originalString,start, length,replacement)说明：将original

13、String中的一部分用replacement替换，start指第一个替换的字符，length指替换的长度。ReplaceWord格式： resultString := ReplaceWord(word, replacer, string)说明：将string中所有的Word用replacer替换后返回。若使用单词的样式，则此样式必须同整个单词匹配且没有跳跃。可以使用特殊字符来扩大查找范围，如：“*”：代表零个或多个字符；“？”：代表任何单一字符；“”： 查找特殊字符果，和特殊字符合用。如：“?”指字符“?”。RFind格式： number := RFind(pattern, string)说

14、明：使用同Find函数，只是查找最后一个匹配。string格式： string := String(x)说明：将value的数据类型转化为字符串类型。Strip格式： resultString := Strip(characters, string)说明：将字符串string中出现在character字符串中的字符删除后返回。此函数对大小写敏感。SubStr格式： resultString := SubStr(string, first, last)说明：取出字符串string中的一个子字符串，first和last是起始位置和终止位置。Symbol格式： symbol := Symbol(va

15、lue)说明：将指定的从当前数据类型转换成属性表中的属性字符“#.”，如果参数value是字符型数据，则返回的是“# value”。它在生成变量的属性时非常有用。注意：属性列表中的符号是不区分大小写的。UpperCase格式： resultString := UpperCase(string)说明：将string中所有小写字母转为大写。WordCount格式： number := WordCount(string)说明：返回字符串string中所含单词总数，以空格、TAB、回车符等为间隔符。表C-3 CMI计算机管理类函数函数说明CMIAddComment格式： resultString:=C

16、MIAddComment(index, comment)说明：增加一个课程内容，index可以是任意数值，在这个参数定义的位置替换原有内容。CMIAddInteraction格式： rusultString:=CMIAddInteraction(Date, Time, Interaction ID, Objective ID, Type, Correct Response, Student Response, Result, Weight, Latency)说明：在当前CMI系统中添加关于一个交互的信息。注意其日期的格式为DD/MM/YY。不过这种调用不支持对用户数据的操作。使用CMIAddI

17、nteractionEx来添加用户数据。CMIAddInteractionEx格式： resultSting:=CMIAddInteractionEx(Date, Time, Interaction ID, Objective ID, Type, Correct Response, Student Response, Result, Weight, Latency, Custom Data)说明：在当前CMI系统中添加关于一个交互的用户数据信息。注意其日期的格式为DD/MM/YY。CMIFinish格式： bool := CMIFinish()说明：将所有跟踪数据传送到服务器。经过这一操作之后

18、，跟踪数据就可以被任意次数地修改了。跟踪数据传送到服务器后，并不退出当前登录，也可以不再对跟踪数据进行修改。如果操作顺利完成则逻辑值True，若传送操作出现错误则返回False。CMIFlush格式： bool := CMIFlush()说明：将所有跟踪数据传送到服务器。经过这一操作之后，跟踪数据就可以被任意次数地修改了。跟踪数据传送到服务器后，可以不再对跟踪数据进行修改。这一函数可用来保持服务器数据一直跟用户跟踪数据相同。如果操作顺利完成则逻辑值True，若传送操作出现错误则返回False。CMIGetAttempt格式： Attempt Number := CMIGetAttempt()说

19、明：CMI系统返回学生已经学习某课程的次数。CMIGetAttempScore格式： score := CMIGetAttemptScore(attempt)说明：返回学生的学生次数在1和系统变量CMIAttemptCount之间的某次课程的学习成绩。CMIGetAttempStatus格式： status := CMIGetAttemptStatus(attempt)说明：返回学生的学生次数在1和系统变量CMIAttemptCount之间的某次课程的学习状况。CMIGetConfig格式： Data := CMIGetConfig()说明：从CMI系统返回指定课程的配置信息。CMIGetCo

20、urseID格式： CMIGetCourseID()说明：从CMI系统返回指定课程的课程号。CMIGetCustomField格式： data := CMIGetCustomField(Table Name, Field Name)说明：返回由Table Name表名和Field Name域名标识的用户域。CMIGetData格式： Data := CMIGetData()说明：从CMI系统返回各种课程有关信息。CMIGetDemographics格式： data := CMIGetDemographics(Field Name)说明：由Field Name域名指定的学生的统计数据。CMIGe

21、tLastError格式： error := CMIGetLastError()说明：返回最近发生的错误值。若无错误发生则返回0。CMIGetLocation格式： Location := CMIGetLocation()说明：从CMI系统返回最后一次用户离开课程时其在课程中的浏览位置。CMIGetMasteryScore格式： score := CMIGetMasteryScore()说明：返回CMI系统中课程的成绩。CMIGetObjCount格式： count := CMIGetObjCount()说明：返回与此课程相关的学习任务的个数。CMIGetObjID格式： id := CMIG

22、etObjID(index)说明：返回由index指定的学习任务的标识符（该index值由0开始到系统变量CMIObjCount为止）。CMIGetObjScore格式： score := CMIGetObjScore(index)说明：返回由index指定的学习任务的成绩（该index值由1开始到系统变量CMIObjCount为止）。CMIGetObjStatus格式： status := CMIGetObjStatus(index)说明：返回由index指定的学习任务的状态信息（该index值由1开始到系统变量CMIObjCount为止）。CMIGetPath格式： Path := CMI

23、GetPath()说明：从CMI系统返回学生私人目录的路径。此函数只能用在CMI系统的局域网版本上，广域网的版本不支持学生的私人目录。CMIGetScore格式： Score := CMIGetScore()说明：从CMI系统返回学生的课程成绩CMIGetStatus格式： Status := CMIGetStatus()说明：从CMI系统返回学生上一次退出课程的状态信息。CMIGetTime格式： Seconds := CMIGetTime()说明：从CMI系统返回学生学习课程所用的时间。CMIGetUserID格式： User ID := CMIGetUserID()说明： 从CMI系统返

24、回用户ID号CMIGetUserName格式： UserName := CMIGetUserName()说明： 从CMI系统返回用户名称CMIInitialize格式： bool := CMIInitialize()说明：允许CMI系统在执行前进行任何必须的初始化。此函数必须在其他CMI函数之前执行。第二次调用此函数将不会有任何作用，除非执行了CMIFinish函数。如果初始化顺利完成则返回逻辑值True，若初始化出现错误，则返回False。CMIIsAttemptCompleted格式： bool := CMIIsAttemptCompleted(attempt)说明：根据指定的Attemp

25、t尝试标识号返回是否一次尝试已经完成（该尝试标识号从1开始）。CMIIsAttemptFailed格式：bool := CMIIsAttemptFailed(attempt)说明：根据指定的Attempt尝试标识号返回是否一次尝试已经失败（该尝试标识号从1开始）。CMIIsAttemptPassed格式： bool := CMIIsAttemptPassed(attempt)说明：根据指定的Attempt尝试标识号返回是否一次尝试已经通过（该尝试标识号从1开始）。返回学生是否通过了测试。CMIIsAttemptStarted格式： bool := CMIIsAttemptStarted(att

26、empt)说明：根据指定的Attempt尝试标识号返回是否一次尝试已经开始（该尝试标识号从1开始）。返回学生是否通过了测试。CMIIsCompleted格式： Completed := CMIIsCompleted()说明：如果课程学习已完成则从CMI系统返回逻辑值TRUE。CMIIsFailed格式： bool := CMIIsFailed()说明：确定是否一次课程学习失败。CMIIsObjCompleted格式： bool := CMIIsObjCompleted(index)说明：根据给定的索引号返回是否一项学习任务已经完成（该索引号由1开始）。CMIIsObjFailed格式： boo

27、l := CMIIsObjFailed(index)说明：根据给定的索引号返回是否一项学习任务失败（该索引号由1开始）。CMIIsObjPassed格式： bool := CMIIsObjPassed(index)说明：根据给定的索引号返回是否一项学习任务已通过（该索引号由1开始）。CMIIsObjStarted格式： bool := CMIIsObjStarted(index)说明：根据给定的索引号返回是否一项学习任务已开始（该索引号由1开始）。CMIIsPassed格式： bool := CMIIsPassed()说明：确定是否一次课程学习已通过。CMIIsStarted格式： Compl

28、eted := CMIIsStarted()说明：确定是否一次课程学习已开始，若是则返回True，否则返回False。CMILogin格式： bool := CMILogin(Sign-on Name, Password, Lesson ID, CGI URL)说明：将学生登记的姓名（Sign-on Name）和密码（Password）登记入服务器。参数Lesson ID是课程的标识符；参数CGI URL是指使用的CGI脚本的位置，如http:/hostname/scripts/pwcgi.exe等。 若函数调用成功则返回True，否则返回False。CMILogout格式： bool :=

29、CMILogout()说明：使学生从当前状态退出登录。若还没有被执行CMIFinish()，则跟踪数据将被传送到服务器中。若函数调用成功则返回True，否则返回False。CMIReadComplete格式： CMIReadComplete()说明：当从获得所有信息后必须执行此函数。CMISetCompleted格式： CMISetCompleted()说明： 将课程设置成完成状态CMISetCustomField格式： CMISetCustomField(Table Name, Field Name, Data)说明：根据指定的表名（Table Name）和域名（Field Name）设置用

30、户域的信息。CMISetData格式： CMISetData(Data)说明：将各种课程信息传送到服务器。CMISetFailed格式： CMISetFailed()说明： 将课程设置为失败CMISetLocation格式： CMISetLocation(Location)说明：将当前课程的位置对象传送到CMI系统。CMISetLoggedOut格式： CMISetLoggedOut()说明： 设置课程退出CMISetObj格式： CMISetObj(index, id, score, status, started, completed, passed, failed)说明：根据给定的索引号（index）设置一个学习任务的有关信息。CMISetPassed格式： CMISetPassed()说明： 设置课程通过CMISetScore格式： CMISetScore(Score)说明： 向CMI系统传输课程成绩CMISetStarted格式： CMISetStarted()说明： 设置课程开始CMI