#authorware系统函数.docx

1、#authorware系统函数Authorware 6完全教程网上赠品附录CAuthorware 6.0系统函数一览表使用系统函数，一方面可以进行数据处理，另一方面可以控制Authorware执行特定的操作，完成不同的功能。Authorware6.0 提供了大量系统函数，大大增强了对程序流程的控制能力。Authorware 6.0比5.x版本新增了16个函数，详见表C-1。表C-1 Authorware 6.0新增系统函数及其说明函数说明GetExternalMedia返回在代码或库中使用的外部的媒体文件的完整的列表。GetFunctionList根据指定的类别说明：将指定字符串“string

2、”中每一个单词的首字母变为大写返回给变量resultString。，Authorware通过字符间的空格来识别单词。若只想转化第一个单词的首字母，则加上参数“1”。Char格式： string := Char(key说明：取Key所指定的ASC码或键对应的字符、数字、符号、或键名。CharCount格式： number := CharCount(string说明： 返回字符串中的字符个数，包括空格和特殊字符Code格式： number := Code(character说明：返回字符、数字、符号、或键名对应的ASCII码，若是键名，则不用引号。可用此函数查找文件中用作分隔符的字符。非ASCII

3、码的数字代码在Windows和Macintosh平台上可能不同。DeleteLine格式：resultString := DeleteLine(string, n , m , delim说明：从字符串string中删除第n行后，将剩下的内容返回。若定义了m值，则删除第n行到第m行。若定义了delim参数，则将各行的分隔符设为delim 指定值。缺省各行间用回车符说明：计算表达式“expression”的值，将结果赋给变量result。此函数能解释包括数学表达式在内的各种字符串。不能用此函数计算包含:=操作符的表达式，但可以使用EvalAssign函数将这一操作的结果赋给一个变量说明： 同系统函

4、数Eval，只是可以使用:=操作符。Find格式： number := Find(pattern, string说明：查找并返回由pattern指定的字符在字符串string中的第一个位置，如果没有找到则返回0。此函数区分大小写，故使用前可用LowerCase或UpperCase函数转化字符串。可以使用特殊字符来扩大查找范围，如：“*”：代表零个或多个字符；“？”：代表任何单一字符；“”：查找特殊字符果，和特殊字符合用。如：“?”指字符“?”。GetLine格式：resultString := GetLine(string, n , m, delim说明：将字符串第n行赋给变量resultSt

5、ring，定义参数m，则返回第nm行。缺省行与行之间缺省用回车符间隔。用delim参数来更改间隔符的设定，如TAB符等。注意：使用delim参数则必须使用m参数，即使只获得一行。GetNumber格式： number := GetNumber(n, string说明：返回字符串中第n个数字值给变量number，若没有找到，则返回0。GetWord格式： resultString := GetWord(n, string说明：返回字符串中第n个单词给变量resultString，若没有找到，则返回空串说明： 将newstring插入到字符串string中的位置，并将结果返回。若n=0，则将new

6、string插到第一行前，若n的值大于字符串的总行数，则将newstring插到末尾和第n行之间。缺省时行与行之间用回车符说明：返回字符串string的总行数，包括空白行。缺省时行与行之间用回车符说明：将字符串“string”所有大写字母转化为小写后返回。MapChars格式： string := MapChars(string, fromPlatform , toPlatform说明：将字符串string从fromPlatform平台映射到toPlatform平台。平台Platform的值为：0 当前平台1 Windows平台2 Macintosh平台NumCount格式： number :

7、= NumCount(string说明：返回在字符串中数字的个数，Authorware遇到一个空格或非数字字符则认为一个数字终止。Authorware自动将用户最后一个文本交互中的总数字数存在系统变量number中。Reduce格式： resultString := Reduce(set, string说明：按所指定的字符或字符串，将string相应的字符或字符串取出，使set中设置的字符串里的每个字符在取出后的字符串中均相邻，以使字符串string得到简化。RepeatString格式： resultString := RepeatString(string, n说明：将字符串string重

8、复n次后赋给变量resultString。Replace格式： resultString := Replace(pattern,replacer,string说明：将字符串string中的子串pattern 用指定字符串replacer替换，然后返回。可以使用特殊字符来扩大查找范围，如：“*”：代表零个或多个字符；“？”：代表任何单一字符；“”：查找特殊字符果，和特殊字符合用。如：“?”指字符“?”。ReplaceLine格式： Result := ReplaceLine(string, n, newstring, delim说明：返回用字符串newstring替换字符串string中的第n行

9、子串的结果。ReplaceString格式： resultString := ReplaceString(originalString,start, length,replacement说明：将originalString中的一部分用replacement替换，start指第一个替换的字符，length指替换的长度。ReplaceWord格式： resultString := ReplaceWord(word, replacer, string说明：将string中所有的Word用replacer替换后返回。若使用单词的样式，则此样式必须同整个单词匹配且没有跳跃。可以使用特殊字符来扩大查找范围

10、，如：“*”：代表零个或多个字符；“？”：代表任何单一字符；“”：查找特殊字符果，和特殊字符合用。如：“?”指字符“?”。RFind格式： number := RFind(pattern, string说明：使用同Find函数，只是查找最后一个匹配。string格式： string := String(x说明：将value的数据类型转化为字符串类型。Strip格式： resultString := Strip(characters, string说明：将字符串string中出现在character字符串中的字符删除后返回。此函数对大小写敏感。SubStr格式： resultString :=

11、SubStr(string, first, last说明：取出字符串string中的一个子字符串，first和last是起始位置和终止位置。Symbol格式： symbol := Symbol(value说明：将指定的从当前数据类型转换成属性表中的属性字符“#.”，如果参数value是字符型数据，则返回的是“# value”。它在生成变量的属性时非常有用。注意：属性列表中的符号是不区分大小写的。UpperCase格式： resultString := UpperCase(string说明：将string中所有小写字母转为大写。WordCount格式： number := WordCount(s

12、tring说明：返回字符串string中所含单词总数，以空格、TAB、回车符等为间隔符。表C-3 CMI计算机管理类函数函数说明CMIAddComment格式： resultString:=CMIAddComment(index, comment说明：增加一个课程内容，index可以是任意数值，在这个参数定义的位置替换原有内容。CMIAddInteraction格式： rusultString:=CMIAddInteraction(Date, Time, Interaction ID, Objective ID, Type, Correct Response, Student Response

13、, Result, Weight, Latency说明：在当前CMI系统中添加关于一个交互的信息。注意其日期的格式为DD/MM/YY。不过这种调用不支持对用户数据的操作。使用CMIAddInteractionEx来添加用户数据。CMIAddInteractionEx格式： resultSting:=CMIAddInteractionEx(Date, Time, Interaction ID, Objective ID, Type, Correct Response, Student Response, Result, Weight, Latency, Custom Data说明：在当前CMI系

14、统中添加关于一个交互的用户数据信息。注意其日期的格式为DD/MM/YY。CMIFinish格式： bool := CMIFinish(说明：将所有跟踪数据传送到服务器。经过这一操作之后，跟踪数据就可以被任意次数地修改了。跟踪数据传送到服务器后，并不退出当前登录，也可以不再对跟踪数据进行修改。如果操作顺利完成则逻辑值True，若传送操作出现错误则返回False。CMIFlush格式： bool := CMIFlush(说明：将所有跟踪数据传送到服务器。经过这一操作之后，跟踪数据就可以被任意次数地修改了。跟踪数据传送到服务器后，可以不再对跟踪数据进行修改。这一函数可用来保持服务器数据一直跟用户跟踪

15、数据相同。如果操作顺利完成则逻辑值True，若传送操作出现错误则返回False。CMIGetAttempt格式： Attempt Number := CMIGetAttempt(说明：CMI系统返回学生已经学习某课程的次数。CMIGetAttempScore格式： score := CMIGetAttemptScore(attempt说明：返回学生的学生次数在1和系统变量CMIAttemptCount之间的某次课程的学习成绩。CMIGetAttempStatus格式： status := CMIGetAttemptStatus(attempt说明：返回学生的学生次数在1和系统变量CMIAtte

16、mptCount之间的某次课程的学习状况。CMIGetConfig格式： Data := CMIGetConfig(说明：从CMI系统返回指定课程的配置信息。CMIGetCourseID格式： CMIGetCourseID(说明：从CMI系统返回指定课程的课程号。CMIGetCustomField格式： data := CMIGetCustomField(Table Name, Field Name说明：返回由Table Name表名和Field Name域名标识的用户域。CMIGetData格式： Data := CMIGetData(说明：从CMI系统返回各种课程有关信息。CMIGetDe

17、mographics格式： data := CMIGetDemographics(Field Name说明：由Field Name域名指定的学生的统计数据。CMIGetLastError格式： error := CMIGetLastError(说明：返回最近发生的错误值。若无错误发生则返回0。CMIGetLocation格式： Location := CMIGetLocation(说明：从CMI系统返回最后一次用户离开课程时其在课程中的浏览位置。CMIGetMasteryScore格式： score := CMIGetMasteryScore(说明：返回CMI系统中课程的成绩。CMIGetOb

18、jCount格式： count := CMIGetObjCount(说明：返回与此课程相关的学习任务的个数。CMIGetObjID格式： id := CMIGetObjID(index说明：返回由index指定的学习任务的标识符说明：返回由index指定的学习任务的成绩说明：返回由index指定的学习任务的状态信息说明：从CMI系统返回学生私人目录的路径。此函数只能用在CMI系统的局域网版本上，广域网的版本不支持学生的私人目录。CMIGetScore格式： Score := CMIGetScore(说明：从CMI系统返回学生的课程成绩CMIGetStatus格式： Status := CMIG

19、etStatus(说明：从CMI系统返回学生上一次退出课程的状态信息。CMIGetTime格式： Seconds := CMIGetTime(说明：从CMI系统返回学生学习课程所用的时间。CMIGetUserID格式： User ID := CMIGetUserID(说明： 从CMI系统返回用户ID号CMIGetUserName格式： UserName := CMIGetUserName(说明： 从CMI系统返回用户名称CMIInitialize格式： bool := CMIInitialize(说明：允许CMI系统在执行前进行任何必须的初始化。此函数必须在其他CMI函数之前执行。第二次调用此

20、函数将不会有任何作用，除非执行了CMIFinish函数。如果初始化顺利完成则返回逻辑值True，若初始化出现错误，则返回False。CMIIsAttemptCompleted格式： bool := CMIIsAttemptCompleted(attempt说明：根据指定的Attempt尝试标识号返回是否一次尝试已经完成说明：根据指定的Attempt尝试标识号返回是否一次尝试已经失败说明：根据指定的Attempt尝试标识号返回是否一次尝试已经通过说明：根据指定的Attempt尝试标识号返回是否一次尝试已经开始说明：如果课程学习已完成则从CMI系统返回逻辑值TRUE。CMIIsFailed格式：

21、bool := CMIIsFailed(说明：确定是否一次课程学习失败。CMIIsObjCompleted格式： bool := CMIIsObjCompleted(index说明：根据给定的索引号返回是否一项学习任务已经完成说明：根据给定的索引号返回是否一项学习任务失败说明：根据给定的索引号返回是否一项学习任务已通过说明：根据给定的索引号返回是否一项学习任务已开始说明：确定是否一次课程学习已通过。CMIIsStarted格式： Completed := CMIIsStarted(说明：确定是否一次课程学习已开始，若是则返回True，否则返回False。CMILogin格式： bool :=

22、CMILogin(Sign-on Name, Password, Lesson ID, CGI URL说明：将学生登记的姓名Sign-on Name）和密码说明：使学生从当前状态退出登录。若还没有被执行CMIFinish(，则跟踪数据将被传送到服务器中。若函数调用成功则返回True，否则返回False。CMIReadComplete格式： CMIReadComplete(说明：当从获得所有信息后必须执行此函数。CMISetCompleted格式： CMISetCompleted(说明： 将课程设置成完成状态CMISetCustomField格式： CMISetCustomField(Table

23、 Name, Field Name, Data说明：根据指定的表名Table Name）和域名说明：将各种课程信息传送到服务器。CMISetFailed格式： CMISetFailed(说明： 将课程设置为失败CMISetLocation格式： CMISetLocation(Location说明：将当前课程的位置对象传送到CMI系统。CMISetLoggedOut格式： CMISetLoggedOut(说明： 设置课程退出CMISetObj格式： CMISetObj(index, id, score, status, started, completed, passed, failed说明：根据给定的索引号说明： 设置课程通过CMISetScore格式： CMISetScore(Score说明： 向CMI系统传输课程成绩CMISetStarted格式： CMISetStarted(说明： 设置课程开始CMISetStatus格式： C