#authorware系统函数.docx

#authorware系统函数.docx

《#authorware系统函数.docx》由会员分享，可在线阅读，更多相关《#authorware系统函数.docx（126页珍藏版）》请在冰点文库上搜索。

#authorware系统函数

《Authorware6完全教程》网上赠品

附录CAuthorware6.0系统函数一览表

使用系统函数，一方面可以进行数据处理，另一方面可以控制Authorware执行特定的操作，完成不同的功能。

Authorware6.0提供了大量系统函数，大大增强了对程序流程的控制能力。

Authorware6.0比5.x版本新增了16个函数，详见表C-1。

表C-1Authorware6.0新增系统函数及其说明

函数

说明

GetExternalMedia

返回在代码或库中使用的外部的媒体文件的完整的列表。

GetFunctionList

根据指定的类别

GetLibraryInfo

返回当前的程序文件与相联系的所有的库的线性列表。

GetPasteHand

返回最靠近粘贴指针的图标的ID。

GetSelectedIcons

返回描述在当前组图标中选中的图标的线性列表。

GetVariableList

返回指定的类别中的变量的信息的属性列表。

GroupIcons

把选择的图标放到一个组图标中。

OpenFile

打开指定的程序文件。

OpenLibrary

打开指定内容的库文件。

PackageFile

把当前打开的程序文件打包。

PackageLibrary

打包指定的库文件。

SaveLibrary

保存指定内容的库文件。

SetHotObject

将当前使用的物体设为热物响应。

SetMotionObject

将当前使用的物体设为移动图标使用的物体。

SetTargetObject

将当前使用的物体设为目标响应。

UngroupIcons

把选中的组图标的组取消。

Authorware6.0提供的系统函数共358个，分为17个类别，下面分类说明。

表C-2Character——字符管理类函数

函数

说明

Capitalize

格式：

resultString:

=Capitalize（"string"[,1]>

说明：

将指定字符串“string”中每一个单词的首字母变为大写返回给变量resultString。

，Authorware通过字符间的空格来识别单词。

若只想转化第一个单词的首字母，则加上参数“1”。

Char

格式：

string:

=Char（key>

说明：

取Key所指定的ASCⅡ码或键对应的字符、数字、符号、或键名。

CharCount

格式：

number:

=CharCount（"string">

说明：

返回字符串中的字符个数，包括空格和特殊字符

Code

格式：

number:

=Code（"character">

说明：

返回字符、数字、符号、或键名对应的ASCII码，若是键名，则不用引号。

可用此函数查找文件中用作分隔符的字符。

非ASCII码的数字代码在Windows和Macintosh平台上可能不同。

DeleteLine

格式：

resultString:

=DeleteLine（"string",n[,m[,delim]]>

说明：

从字符串string中删除第n行后，将剩下的内容返回。

若定义了m值，则删除第n行到第m行。

若定义了delim参数，则将各行的分隔符设为delim指定值。

缺省各行间用回车符

Eval,

格式：

result:

=Eval（"expression"[,decimal,separator]>

说明：

计算表达式“expression”的值，将结果赋给变量result。

此函数能解释包括数学表达式在内的各种字符串。

不能用此函数计算包含:

=操作符的表达式，但可以使用EvalAssign函数将这一操作的结果赋给一个变量<可包含:

=操作符）。

Decimal参数确定表达式中的哪一个字符用作小数点。

Separator参数确定表达式中的哪一个字符用作分隔符。

操作系统的定位设置决定了缺省的小数点和分隔符。

需要确定表达式在任何系统上皆能正确运行。

使用这两个系统函数发生的语法错误信息保存在系统变量EvalStatus和EvalMessage中。

EvalAssign

格式：

result:

=EvalAssign（"expression"[,decimal,separator]>

说明：

同系统函数Eval，只是可以使用:

=操作符。

Find

格式：

number:

=Find（"pattern","string">

说明：

查找并返回由pattern指定的字符在字符串string中的第一个位置，如果没有找到则返回0。

此函数区分大小写，故使用前可用LowerCase或UpperCase函数转化字符串。

可以使用特殊字符来扩大查找范围，如：

“*”：

代表零个或多个字符；

“？

”：

代表任何单一字符；

“\”：

查找特殊字符果，和特殊字符合用。

如：

“\?

”指字符“?

”。

GetLine

格式：

resultString:

=GetLine（"string",n[,m,delim]>

说明：

将字符串第n行赋给变量resultString，定义参数m，则返回第n—m行。

缺省行与行之间缺省用回车符间隔。

用delim参数来更改间隔符的设定，如TAB符等。

注意：

使用delim参数则必须使用m参数，即使只获得一行。

GetNumber

格式：

number:

=GetNumber（n,"string">

说明：

返回字符串中第n个数字值给变量number，若没有找到，则返回0。

GetWord

格式：

resultString:

=GetWord（n,"string">

说明：

返回字符串中第n个单词给变量resultString，若没有找到，则返回空串

InsertLine

格式：

resultString:

=InsertLine（"string",n,"newString"[,delim]>

说明：

将newstring插入到字符串string中的位置，并将结果返回。

若n=0，则将newstring插到第一行前，若n的值大于字符串的总行数，则将newstring插到末尾和第n行之间。

缺省时行与行之间用回车符

TAB符等。

LineCount

格式：

number:

=LineCount（"string"[,delim]>

说明：

返回字符串string的总行数，包括空白行。

缺省时行与行之间用回车符

TAB符等。

LowerCase

格式：

resultString:

=LowerCase（"string">

说明：

将字符串“string”所有大写字母转化为小写后返回。

MapChars

格式：

string:

=MapChars（"string",fromPlatform[,toPlatform]>

说明：

将字符串string从fromPlatform平台映射到toPlatform平台。

平台Platform的值为：

0当前平台

1Windows平台

2Macintosh平台

NumCount

格式：

number:

=NumCount（"string">

说明：

返回在字符串中数字的个数，Authorware遇到一个空格或非数字字符则认为一个数字终止。

Authorware自动将用户最后一个文本交互中的总数字数存在系统变量number中。

Reduce

格式：

resultString:

=Reduce（"set","string">

说明：

按所指定的字符或字符串，将string相应的字符或字符串取出，使set中设置的字符串里的每个字符在取出后的字符串中均相邻，以使字符串string得到简化。

RepeatString

格式：

resultString:

=RepeatString（"string",n>

说明：

将字符串string重复n次后赋给变量resultString。

Replace

格式：

resultString:

=Replace（"pattern","replacer","string">

说明：

将字符串string中的子串pattern用指定字符串replacer替换，然后返回。

可以使用特殊字符来扩大查找范围，如：

“*”：

代表零个或多个字符；

“？

”：

代表任何单一字符；

“\”：

查找特殊字符果，和特殊字符合用。

如：

“\?

”指字符“?

”。

ReplaceLine

格式：

Result:

=ReplaceLine（"string",n,"newstring"[,delim]>

说明：

返回用字符串newstring替换字符串string中的第n行子串的结果。

ReplaceString

格式：

resultString:

=ReplaceString（"originalString",start,length,"replacement">

说明：

将originalString中的一部分用replacement替换，start指第一个替换的字符，length指替换的长度。

ReplaceWord

格式：

resultString:

=ReplaceWord（"word","replacer","string">

说明：

将string中所有的Word用replacer替换后返回。

若使用单词的样式，则此样式必须同整个单词匹配且没有跳跃。

可以使用特殊字符来扩大查找范围，如：

“*”：

代表零个或多个字符；

“？

”：

代表任何单一字符；

“\”：

查找特殊字符果，和特殊字符合用。

如：

“\?

”指字符“?

”。

RFind

格式：

number:

=RFind（"pattern","string">

说明：

使用同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（value>

说明：

将指定的从当前数据类型转换成属性表中的属性字符“#...”，如果参数value是字符型数据，则返回的是“#value”。

它在生成变量的属性时非常有用。

注意：

属性列表中的符号是不区分大小写的。

UpperCase

格式：

resultString:

=UpperCase（"string">

说明：

将string中所有小写字母转为大写。

WordCount

格式：

number:

=WordCount（"string">

说明：

返回字符串string中所含单词总数，以空格、TAB、回车符等为间隔符。

表C-3CMI——计算机管理类函数

函数

说明

CMIAddComment

格式：

resultString:

=CMIAddComment（index,comment>

说明：

增加一个课程内容，index可以是任意数值，在这个参数定义的位置替换原有内容。

CMIAddInteraction

格式：

rusultString:

=CMIAddInteraction（Date,Time,InteractionID,ObjectiveID,Type,CorrectResponse,StudentResponse,Result,Weight,Latency>

说明：

在当前CMI系统中添加关于一个交互的信息。

注意其日期的格式为DD/MM/YY。

不过这种调用不支持对用户数据的操作。

使用CMIAddInteractionEx来添加用户数据。

CMIAddInteractionEx

格式：

resultSting:

=CMIAddInteractionEx（Date,Time,InteractionID,ObjectiveID,Type,CorrectResponse,StudentResponse,Result,Weight,Latency,CustomData>

说明：

在当前CMI系统中添加关于一个交互的用户数据信息。

注意其日期的格式为DD/MM/YY。

CMIFinish

格式：

bool:

=CMIFinish（>

说明：

将所有跟踪数据传送到服务器。

经过这一操作之后，跟踪数据就可以被任意次数地修改了。

跟踪数据传送到服务器后，并不退出当前登录，也可以不再对跟踪数据进行修改。

如果操作顺利完成则逻辑值True，若传送操作出现错误则返回False。

CMIFlush

格式：

bool:

=CMIFlush（>

说明：

将所有跟踪数据传送到服务器。

经过这一操作之后，跟踪数据就可以被任意次数地修改了。

跟踪数据传送到服务器后，可以不再对跟踪数据进行修改。

这一函数可用来保持服务器数据一直跟用户跟踪数据相同。

如果操作顺利完成则逻辑值True，若传送操作出现错误则返回False。

CMIGetAttempt

格式：

AttemptNumber:

=CMIGetAttempt（>

说明：

CMI系统返回学生已经学习某课程的次数。

CMIGetAttempScore

格式：

score:

=CMIGetAttemptScore（attempt>

说明：

返回学生的学生次数在1和系统变量CMIAttemptCount之间的某次课程的学习成绩。

CMIGetAttempStatus

格式：

status:

=CMIGetAttemptStatus（attempt>

说明：

返回学生的学生次数在1和系统变量CMIAttemptCount之间的某次课程的学习状况。

CMIGetConfig

格式：

Data:

=CMIGetConfig（>

说明：

从CMI系统返回指定课程的配置信息。

CMIGetCourseID

格式：

CMIGetCourseID（>

说明：

从CMI系统返回指定课程的课程号。

CMIGetCustomField

格式：

data:

=CMIGetCustomField（TableName,FieldName>

说明：

返回由TableName表名和FieldName域名标识的用户域。

CMIGetData

格式：

Data:

=CMIGetData（>

说明：

从CMI系统返回各种课程有关信息。

CMIGetDemographics

格式：

data:

=CMIGetDemographics（FieldName>

说明：

由FieldName域名指定的学生的统计数据。

CMIGetLastError

格式：

error:

=CMIGetLastError（>

说明：

返回最近发生的错误值。

若无错误发生则返回0。

CMIGetLocation

格式：

Location:

=CMIGetLocation（>

说明：

从CMI系统返回最后一次用户离开课程时其在课程中的浏览位置。

CMIGetMasteryScore

格式：

score:

=CMIGetMasteryScore（>

说明：

返回CMI系统中课程的成绩。

CMIGetObjCount

格式：

count:

=CMIGetObjCount（>

说明：

返回与此课程相关的学习任务的个数。

CMIGetObjID

格式：

id:

=CMIGetObjID（index>

说明：

返回由index指定的学习任务的标识符<该index值由0开始到系统变量CMIObjCount为止）。

CMIGetObjScore

格式：

score:

=CMIGetObjScore（index>

说明：

返回由index指定的学习任务的成绩<该index值由1开始到系统变量CMIObjCount为止）。

CMIGetObjStatus

格式：

status:

=CMIGetObjStatus（index>

说明：

返回由index指定的学习任务的状态信息<该index值由1开始到系统变量CMIObjCount为止）。

CMIGetPath

格式：

Path:

=CMIGetPath（>

说明：

从CMI系统返回学生私人目录的路径。

此函数只能用在CMI系统的局域网版本上，广域网的版本不支持学生的私人目录。

CMIGetScore

格式：

Score:

=CMIGetScore（>

说明：

从CMI系统返回学生的课程成绩

CMIGetStatus

格式：

Status:

=CMIGetStatus（>

说明：

从CMI系统返回学生上一次退出课程的状态信息。

CMIGetTime

格式：

Seconds:

=CMIGetTime（>

说明：

从CMI系统返回学生学习课程所用的时间。

CMIGetUserID

格式：

UserID:

=CMIGetUserID（>

说明：

从CMI系统返回用户ID号

CMIGetUserName

格式：

UserName:

=CMIGetUserName（>

说明：

从CMI系统返回用户名称

CMIInitialize

格式：

bool:

=CMIInitialize（>

说明：

允许CMI系统在执行前进行任何必须的初始化。

此函数必须在其他CMI函数之前执行。

第二次调用此函数将不会有任何作用，除非执行了CMIFinish函数。

如果初始化顺利完成则返回逻辑值True，若初始化出现错误，则返回False。

CMIIsAttempt

Completed

格式：

bool:

=CMIIsAttemptCompleted（attempt>

说明：

根据指定的Attempt尝试标识号返回是否一次尝试已经完成<该尝试标识号从1开始）。

CMIIsAttemptFailed

格式：

bool:

=CMIIsAttemptFailed（attempt>

说明：

根据指定的Attempt尝试标识号返回是否一次尝试已经失败<该尝试标识号从1开始）。

CMIIsAttemptPassed

格式：

bool:

=CMIIsAttemptPassed（attempt>

说明：

根据指定的Attempt尝试标识号返回是否一次尝试已经通过<该尝试标识号从1开始）。

返回学生是否通过了测试。

CMIIsAttemptStarted

格式：

bool:

=CMIIsAttemptStarted（attempt>

说明：

根据指定的Attempt尝试标识号返回是否一次尝试已经开始<该尝试标识号从1开始）。

返回学生是否通过了测试。

CMIIsCompleted

格式：

Completed:

=CMIIsCompleted（>

说明：

如果课程学习已完成则从CMI系统返回逻辑值TRUE。

CMIIsFailed

格式：

bool:

=CMIIsFailed（>

说明：

确定是否一次课程学习失败。

CMIIsObjCompleted

格式：

bool:

=CMIIsObjCompleted（index>

说明：

根据给定的索引号返回是否一项学习任务已经完成<该索引号由1开始）。

CMIIsObjFailed

格式：

bool:

=CMIIsObjFailed（index>

说明：

根据给定的索引号返回是否一项学习任务失败<该索引号由1开始）。

CMIIsObjPassed

格式：

bool:

=CMIIsObjPassed（index>

说明：

根据给定的索引号返回是否一项学习任务已通过<该索引号由1开始）。

CMIIsObjStarted

格式：

bool:

=CMIIsObjStarted（index>

说明：

根据给定的索引号返回是否一项学习任务已开始<该索引号由1开始）。

CMIIsPassed

格式：

bool:

=CMIIsPassed（>

说明：

确定是否一次课程学习已通过。

CMIIsStarted

格式：

Completed:

=CMIIsStarted（>

说明：

确定是否一次课程学习已开始，若是则返回True，否则返回False。

CMILogin

格式：

bool:

=CMILogin（Sign-onName,Password,LessonID,CGIURL>

说明：

将学生登记的姓名

参数LessonID是课程的标识符；参数CGIURL是指使用的CGI脚本的位置，如等。

若函数调用成功则返回True，否则返回False。

CMILogout

格式：

bool:

=CMILogout（>

说明：

使学生从当前状态退出登录。

若还没有被执行CMIFinish（>，则跟踪数据将被传送到服务器中。

若函数调用成功则返回True，否则返回False。

CMIReadComplete

格式：

CMIReadComplete（>

说明：

当从获得所有信息后必须执行此函数。

CMISetCompleted

格式：

CMISetCompleted（>

说明：

将课程设置成完成状态

CMISetCustomField

格式：

CMISetCustomField（TableName,FieldName,Data>

说明：

根据指定的表名

CMISetData

格式：

CMISetData（Data>

说明：

将各种课程信息传送到服务器。

CMISetFailed

格式：

CMISetFailed（>

说明：

将课程设置为失败

CMISetLocation

格式：

CMISetLocation（Location>

说明：

将当前课程的位置对象传送到CMI系统。

CMISetLoggedOut

格式：

CMISetLoggedOut（>

说明：

设置课程退出

CMISetObj

格式：

CMISetObj（index,id,score,status,started,completed,passed,failed>

说明：

根据给定的索引号

CMISetPassed

格式：

CMISetPassed（>

说明：

设置课程通过

CMISetScore

格式：

CMISetScore（Score>

说明：

向CMI系统传输课程成绩

CMISetStarted

格式：

CMISetStarted（>

说明：

设置课程开始

CMISetStatus

格式：

C