Authorware 60系统函数一览表.docx
《Authorware 60系统函数一览表.docx》由会员分享,可在线阅读,更多相关《Authorware 60系统函数一览表.docx(127页珍藏版)》请在冰点文库上搜索。
Authorware60系统函数一览表
Authorware6.0系统函数一览表
使用系统函数,一方面可以进行数据处理,另一方面可以控制Authorware执行特定的操作,完成不同的功能。
Authorware6.0提供了大量系统函数,大大增强了对程序流程的控制能力。
Authorware6.0比5.x版本新增了16个函数,详见表C-1。
表C-1Authorware6.0新增系统函数及其说明
函数
说明
GetExternalMedia
返回在代码或库中使用的外部的媒体文件的完整的列表。
GetFunctionList
根据指定的类别(category)返回关于函数的信息的属性列表。
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指定值。
缺省各行间用回车符(Return)作为间隔符。
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,若没有找到,则返回空串(null)。
InsertLine
格式:
resultString:
=InsertLine("string",n,"newString"[,delim])
说明:
将newstring插入到字符串string中的位置,并将结果返回。
若n=0,则将newstring插到第一行前,若n的值大于字符串的总行数,则将newstring插到末尾和第n行之间。
缺省时行与行之间用回车符(Return)隔开,可通过设定delim参数将用delim参数值将分隔符更改,如为:
TAB符等。
LineCount
格式:
number:
=LineCount("string"[,delim])
说明:
返回字符串string的总行数,包括空白行。
缺省时行与行之间用回车符(Return)隔开,可通过设定delim参数将用delim参数值将分隔符更改,如为:
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)
说明:
将学生登记的姓名(Sign-onName)和密码(Password)登记入服务器。
参数LessonID是课程的标识符;参数CGIURL是指使用的CGI脚本的位置,如http:
//hostname/scripts/pwcgi.exe等。
若函数调用成功则返回True,否则返回False。
CMILogout
格式:
bool:
=CMILogout()
说明:
使学生从当前状态退出登录。
若还没有被执行CMIFinish(),则跟踪数据将被传送到服务器中。
若函数调用成功则返回True,否则返回False。
CMIReadComplete
格式:
CMIReadComplete()
说明:
当从获得所有信息后必须执行此函数。
CMISetCompleted
格式:
CMISetCompleted()
说明:
将课程设置成完成状态
CMISetCustomField
格式:
CMISetCustomField(TableName,FieldName,Data)
说明:
根据指定的表名(TableName)和域名(FieldName)设置用户域的信息。
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