authorware 6中文教材附录B.docx

authorware 6中文教材附录B.docx

《authorware 6中文教材附录B.docx》由会员分享，可在线阅读，更多相关《authorware 6中文教材附录B.docx（54页珍藏版）》请在冰豆网上搜索。

authorware6中文教材附录B

附录BAuthorware6.0系统变量一览表

使用图标编程方式虽然直观，功能也比较强大，但在完成较大功能时不如编程简单。

使用Authorware提供的变量和函数可以实现编程控制功能。

在Authorware6.0中，系统提供了很多变量，并且在程序运行过程中，系统会自动监测并更改这些变量，它们被称为系统变量。

Authorware6.0提供的变量一共204个，分为11个类别，下面分类说明。

本章内容：

表B-1【CMI】类系统变量

表B-2【Decision】类系统变量

表B-3【File】类系统变量

表B-4【Framework】类系统变量

表B-5【General】类系统变量

表B-6【Graphics】类系统变量

表B-7【Icons】类系统变量

表B-8【Interaction】类系统变量

表B-9【Network】类系统变量

表B-10【Time】类系统变量

表B-11【Video】类系统变量

表B-1【CMI】类系统变量

变量

类型

说明

CMIAttemptCount

数值型

CMIAttemptCount记录着某个用户尝试课程的次数。

一个程序可能是由一个或几个课程组成的CMI系统定义的过程

CMIAttempts

字符型

CMIAttempts包含一个属性列表，记录课程尝试信息。

如果前面没有课程尝试，CMIAttemptCount是零，该列表是空的

CMICompleted

逻辑型

当用户完成学习时CMICompleted的值为TRUE。

一个程序可能是由一个或几个课程组成的CMI系统定义的过程

CMIConfig

字符型

CMIConfig含有进入CMI系统时的结构信息。

对同一过程的所有用户来说字符串的值是一样的。

CMIConfig由CMI系统的使用者修改

CMICourseID

字符型

CMICourseID记录CMI系统中的课程数。

一个程序可能是由一个或几个课程组成的CMI系统定义的过程

CMIData

字符型

使用CMIData可以通过CMI系统在激活数据和用户数据之间交流。

CMIData只记录当前用户的数据，该数据为字符型，最大不能超过16K。

例如CMIData可以记录的用户数据中的书签、参数选择以及模拟数据等等

变量

类型

说明

CMIFailed

逻辑型

如果用户没有完成要求的操作时，CMIFailed的值为TRUE

CMILoggedOut

逻辑型

如果将CMILoggedOut设置为TRUE，用户在活动课程结束时会立即退出CMI系统；如果CMILoggedOut设置为FALSE，用户将继续保留在CMI系统中而不退出CMI系统

CMIMasteryScore

数值型

CMIMasteryScore记录着课程的及格成绩，也可以叫做通过成绩。

CMIMasteryScore是通过CMI系统设置的

CMIObjCount

数值型

CMIObjCount记录的是当前课程中的目标数。

目标是在CMI系统中定义的，CMI系统还会为目标创建一个唯一的目标ID号。

通过在【Properties：

Response】对话框的【CMI】标签中输唯一的目标ID号，将程序中的每一个交互图标都可以被设置成CMI目标

CMIObjectives

字符型

CMIObjectives使用列表方式记录着CMI目标属性。

如果程序中没有CMI目标，即CMIObjCount为0时，该列表为空。

该变量可以用下面的方法使用：

MyVariable:

=CMIObjectives[1..CMIObjCount][#property]

下列属性可以使用但不能进行设置：

#ID

包含目标唯一的目标标识符的字符串

#Score

目标的数字成绩

#Status

记录目标状态的字符串。

该变量的值可能是“Completed”、“Incomplete”或“NotAttempted”

#Completed

用户完成目标后，该变量为TRUE

#Failed

如果用户没有完成目标，该变量为TRUE

#Passed

如果用户通过了目标，该变量为TRUE。

CMIPath

字符型

CMIPath记录用户私有数据所在目录的全称。

CMIPath由CMI系统设置

CMIReadComplete

逻辑型

如果CMIReadComplete设置为TRUE，CMI系统和Authorware之间的数据交换一旦结束，临时文件会立即删除。

如果CMIReadComplete设置为FALSE，CMI系统将在最后删除临时文件

CMIScore

数值型

CMIScore记录课程的数值成绩。

如果在【Properties：

File】对话框的【CMI】标签下选中【Score】复选框，CMIScore和TotalScore的值完全相同

CMIStarted

逻辑型

用户开始课程后，CMIStarted的值为TRUE。

用户没有开始课程或者课程已经结束时，CMIStarted的值为FALSE

CMIStatus

字符型

CMIStatus记录当前课程状态的字符串。

该变量的值可能是“Completed”、“Incomplete”或“NotAttempted”

变量

类型

说明

CMITime

数值型

CMITime变量记录的是用户使用当前课程的秒数。

CMITime记录的是所有用户使用当前课程的累积时间。

如果【Properties：

File】对话框【CMI】标签下的【Time】复选框被选中，CMITime将自动更新

CMITimedOut

逻辑型

将CMITimedOut设置为TRUE时，课程运行过程中，一旦用户长时间没有操作，程序将自动退出CMI系统

CMITrackAlllnteractions

逻辑型

将CMITrackAlllnteractions设置为TRUE，CMI系统就可以跟踪一个文件中的交互流程。

在【Properties：

File】对话框【CMI】标签下选中【AllInteraction】复选框，CMITrackAlllnteractions在程序将开始时被设置为TRUE

将CMITrackInteraction@“IconTitle”设置为TRUE可以使CMI系统跟踪指定的【交互】图标。

要跟踪一个指定的【交互】图标，CMITrackAlllnteractions和CMITrackInteraction@”IconTitle”都应该设置为TRUE

CMIUserID

字符型

CMIUserID记录着CMI系统设置的用户唯一的标志字符串

CMIUserName

字符型

CMIUserName记录着用户登录CMI系统时使用的用户名

TotleScore

数值型

TotalScore变量中记录着课程中用户的总成绩。

每个用户在交互结构中所作的每次响应，其成绩都会加到TotalScore上。

每个课程开始时，TotalScore的初始值都会设置成0

表B-2【Decision】类系统变量

变量

类型

说明

AllSelected

逻辑型

如果当前【决策】图标构建的分枝结构中的所有路径都被执行过，AllSelected的值为TRUE。

使用AllSelected@“IconTitle”可以得到指定【决策】图标的AllSelected值

PathCount

数值型

PathCount记录着当前【决策】图标构建的分枝结构中的路径数。

使用PathCount@“IconTitle”可以得到指定【决策】图标的PathCount值

PathSelected

数值型

PathSelected记录的是当前分枝结构中最后一次选中的路径序数。

Authorware中，路径的序数从左到右分别对应于从1开始的整数，最右边的路径序数与PathCount相同

RepCount

数值型

RepCount记录的是Authorware重复当前分枝结构的次数。

RepCount只能用于循环分枝结构中

SelectedEver

逻辑型

如果Authorware已经执行了最后一个分枝结构中的路径，SelectedEver的值为TRUE。

使用SelectedEver@“IconTitle”可以查看Authorware是否执行过指定交互结构中的【决策】图标或指定的路径。

Authorware在退出某条路径时会为该路径设置SelectedEver；Authorware在退出分枝结构时会为该【决策】图标设置SelectedEver

变量

类型

说明

TimeExpired

逻辑型

如果某个循环分枝结构由于超过了时间限制而退出循环，TimeExpired的值为TRUE。

使用TimeExpired@“IconTitle”可以得到指定分枝结构的TimeExpired值。

如果分枝结构由于其他原因而终止或正在运行，该变量的值为FALSE

TimesSelected

数值型

TimesSelected储存的是最后一个分枝路径被选中的秒数。

当Authorware退出该分枝路径或该值得到255时，Authorware将该变量的值置为0。

使用TimesSelected@“IconName”可以得到指定路径的TimesSelected值

表B-3【File】类系统变量

变量

类型

说明

DiskBytes

数值型

DiskBytes用于存储当前磁盘可用空间的字节数

FileLocation

字符型

FileLocation变量存储的是当前执行的文件所在的文件夹，FileLocation在需要使用路径的函数中可以提供简单的方法

FileLocation在Windows系统下格式为：

"drive:

\directory1\directory2\"

FileName

字符型

FileName变量存储的是当前文件的文件名，但是不储存文件路径

FileNameType

数值型

FileNameType变量只有在Windows95/98或WindowsNT下才有效。

FileNameType变量中存储的是代表文件格式的数字：

0：

DOS类型的文件：

8个字符加上3个扩展名

1：

长文件名，可以长达255个字符

FileSize

数值型

FileSize变量存储的是当前文件的字节数。

在开发者编辑程序或保存程序时，该变量都会变化

IOMessage

字符型

IOMessage变量存储的是最近一次执行系统输入输出（I/O）函数的状态。

在Authorware中，输入输出函数有：

WriteExtFile,ReadExtFile,AppendExtFile,CreateFolder,DeleteFile和RenameFile。

如果这些操作中没有错误，IOMessage的值为“noerror”，其它值表示的含义与用户计算机系统有关

IOStatus

数值型

IOStatus存储的是最近一次执行系统输入输出函数的状态，以数字来标识。

当该值为0的时候，表示没有任何错误，其它的值表示的含义同使用计算机系统的定义有关。

OrigWorkingDirectory

字符型

OrigWorkingDirectiory变量用于为Authorware或打包文件设置工作路径。

该变量存储的是当前运行文件所处的目录位置，该路径由Authorware自动赋值，不能由用户来改动。

当使用JumpFile或JumpFileReturn跳转到其它文件时，该变量的值不变。

PathType

数值型

PathType变量存储的是系统变量或系统函数所返回的路径的格式数字：

0：

drive-based,

1：

UniversalNamingConvention（UNC）

变量

类型

说明

RecordsLocation

字符型

RecordsLocation存储的是用户记录信息文件所存放的文件夹的目录路径，在Windows系统中，该路径的缺省值为：

"C:

\WINDOWS\A5W_DATA\".

SearchPath

字符型

SearchPath存储的是Authorware在执行应用程序时，搜寻所需要外部文件时使用的默认路径。

如果在默认的路径中没有搜寻到所需文件，Authorware将根据SearchPath的设置进行搜索

表B-4【Framework】类系统变量

变量

类型

说明

CurrentPageID

数值型

CurrentPageID变量单独使用时，存储的是当前框架结构中已显示过的最后一页的ID号。

如果当前框架结构中没有任何页显示过，其值为空。

CurrentPageID@"framework"可以得到指定框架结构中的已显示过的最后一页的ID号

CurrentPageNum

数值型

CurrentPageNum变量单独使用时，存储的是当前框架结构中已显示过的最后一页的编号，如果当前框架结构中没有任何页显示过，其值为0。

CurrentPageID@"framework"存储的是指定框架结构中已显示过的最后一页的编号

HotTextClicked

字符型

如果以热文本（即使用文本对象作为热对象）交互做为激活某一操作的方式，且激活方式被设置为单击鼠标、双击鼠标、或鼠标移动到文本上方。

当用户使用上述匹配方法激活该响应时，HotTextClicked保存的是最后一次用户匹配响应的热文本的内容

LastSearchString

字符型

LastSearchString变量存储的是传递给FindText函数的字符串或在【FindWord/Phrase】对话框中输入的正文对象

MatchCount

数值型

MatchCount变量存储的是FindText（）函数查找到目标内容的次数

NavFrom

数值型

在中途退出框架结构时，使用NavForm变量。

当由一个【框架】图标或超文本对象所引起的应用程序跳转到某一页时，NavForm变量存储的是程序离开框架结构时所在页的ID号，NavForm变量常在一个【框架】图标内部结构的出口流程中使用

Navigating

逻辑型

一般在【框架】图标的入口和出口流程处使用Navigating变量。

如果Authorware正在执行跳转或显示下一页时，Navigating的值为TRUE

NavTo

数值型

当由一个【框架】图标或超文本对象所引起的程序跳转到某一页时，NavTo变量存储的是程序目的页的ID号。

NavTo变量常在【框架】图标内部结构的入口流程中使用

PageCount

数值型

单独使用时，PageCount存储的是当前框架结构中包含的总页数。

PageCount@"FrameworkIconTitle"存储的是指定框架结构中包含的总页数。

SearchPercentComplete

数值型

SearchPercentComplete变量可以用于跟踪搜索某一对象的进度：

如果该变量的值为“0”，表示没有进行搜索，即根本没有使用FindText（）函数；如果该变量的值为100表示已经完成整个搜索过程

表B-5【General】类系统变量

变量

类型

说明

AltDown

逻辑型

如果Alt键被按下，AltDown值为TRUE；否则为FALSE

AppType

数值型

AppType变量存储的是打包后的文件所包含的Runtime类型，或未打包的Authorware应用程序的类型。

该变量有四种值：

1：

表示文件打包时Runtime文件类型为Windows3.1的16位文件

2：

表示当文件打包时Runtime文件类型为32位（Windows95或NT）；文件不打包时为Authorware的应用程序

3：

表示文件打包时Runtime文件类型为68KMacintosh

4：

表示当文件打包时Runtime文件类型为PowerMacintosh

AppTypeName

字符型

AppTypeName变量存储的是打包后的文件所包含的Runtime类型，或未打包的Authorware应用程序的类型。

该变量有四种值：

16-bit：

表示文件打包时Runtime文件类型为Windows3.1的16位文件32-bit：

表示当文件打包时Runtime文件类型为32位（Windows95或NT）

文件不打包时为Authorware的应用程序

68k：

表示文件打包时Runtime文件类型为68KMacintosh

PowerPC：

表示当文件打包时Runtime文件类型为PowerMacintosh

CapsLock

逻辑型

如果CapsLock键锁定，CapsLock变量值为TRUE；否则为FALSE

ClickX

数值型

ClickX变量存储的是最后一次敲击鼠标时，鼠标指针到屏幕左边界的像素点数目

ClickY

数值型

ClickY变量存储的是最后一次敲击鼠标时，鼠标指针到屏幕上边界的像素点数目

CommandDown

逻辑型

如果用户按下了Ctrl（windows系统）或Command键（Macintosh系统），则CommandDown变量为TRUE

ControlDown

逻辑型

在Windows系统下，如果用户按下了Ctrl键，ControlDown该变量为TRUE

CursorX,

数值型

CursorX存储的是当前插入点光标距离展示窗口左边界的像素点个数

CursorY

数值型

CursorY存储的是当前插入点光标距离展示窗口上边界的像素点个数

DoubleClick

逻辑型

如果系统认为用户最后两次单击鼠标左键是双击，DoubleClick为TRUE

e

数值型

常数变量，其值等于自然对数的基数，为2.718281828459

EvalMessage

字符型

EvalMessage变量存储的是用户在使用Eval、EvalAssign或CallTarget系统函数时产生的错误。

如果没有错误存在，该变量为空

变量

类型

说明

EvalStatus

数值型

EvalStatus变量存储的是最近一次使用Eval、EvalAssign或CallTarget函数的返回值：

0：

完全正确

1：

表达式太长（上限是409字节）

2：

符号太长（上限是409字节）

3：

未结束的字符串，使用时少了引号

4：

使用了非法的字符和非法的运算符（例如#，!

，%等）

5：

语法错误

6：

运算符使用不正确

7：

检测语句格式不正确

8：

缺少右括弧

9：

缺少左括弧

10：

表达式过于复杂

11：

存储器已满

12：

赋值方式非法

13：

需要赋值运算符

14：

缺少操作数

15：

过多的函数参数

16：

函数参数名称不合法

17：

需要调用函数或需要赋值

18：

内在错误

19：

需要表达式

20：

没有使用

21：

未定义函数

22：

未定义变量

23：

缺少@符号需要的图标名称

24：

不能使用@符号连接系统变量

25：

不能使用@符号连接常用变量

26：

使用@符号连接的图标名称不唯一

27：

变量或函数名称过长

28：

不能使用@符号连接一个默认名称

29：

函数参数不足

30：

函数不能内置使用

31：

系统变量或系统函数版本不正确

32：

在库文件中不能使用@符号

33：

此处需要表达式

34：

需要“IF”

变量

类型

说明

EvalStatus

数值型

35：

需要“then”

36：

需要“end”

37：

需要换行

38：

使用“While”或“With”必须使用“Repeat”

39：

需要“repeat”

40：

repeat-with语句格式应为“repeatwithvariable:

=value[down]tovalue”

41：

repeat结构中必须有“exitrepeat”或“nextrepeat”

42：

函数的参数列表丢失，需要重新载入函数

43：

非法符号

44：

非法列表

45：

需要“]”

46：

非法下标

47：

目标文件无法调用函数

48：

无法定位目标文件

49：

模块对话框正在改变目标文件

50：

目标文件正在运行

51：

在目标处使用【Toolbox】对话框

52：

错误参数

53：

错误变量名称

54：

变量已经存在

55：

操作失败

56：

变量只能在【计算】图标中使用

EventLastMatched

字符型

单独使用时，EventLastMatched变量储存的是最新的事件响应中所匹配的Xtras事件属性列表；EventLastMatched@"IconTitle"的值为指定的事件响应中所匹配的Xtras事件属性列表

EventQueue

字符型

EventQueue变量存储的是由Xtras所发出待处理的事件的列表，这些事件按照响应的顺序来排列

EventsSuspended

数值型

当EventsSuspended的值大于零时，Authorware将所有的需要中断程序流程的事件储存到EventQueue变量中；当EventsSuspended变量的值为零时，Autorware执行这些事件

FileTitle

字符型

FileTitle存储的是在【Properties】对话框中选择显示标题的选项，文件打包后在标题栏出现该变量存储的标题

FirstName

字符型

当用户将全名赋给UserName时，FirstName变量存储的是用户的第一姓名。

GlobalTempo

数值型

GlobalTempo变量存储的是spriteXtras取得步进事件的速率，单位是每秒种多少步。

并不是所有的Xtras都可以取得步进事件

变量

类型

说明

Key

字符型

Key用于存储用户最后一次输入的键值，例如：

h,H,Delete,9,或者Enter

KeyboardFocus

数值型

KeyboardFocus变量存储的是当前需要键盘输入的设计按钮的ID标识。

可以使用SetKeyboardFocus函数来设置该变量的值

KeyNum

数值型

KeyNum用于存储用户最后一次按键的ASCII码

KnowledgeObjectID

字符型

KnowledgeObjectID@"IconTitle"可以得到在【Properties：

KnowledgeObject】对话框中指定的KnowledgeObject表示字符串

一个KnowledgeObjectID可能如下：

MACR-0027-025-AW5.0.0-35950

LicenseInfo

字符型

LicenseInfo存储的是用户安装Authorware6.0时的登记信息，其中包括用户名及公司名

Machine

数值型

Machine使用数字3来标识用户使用的计算机是IBMPC或兼容机

MachineName

字符型

MachineName使用字符串“IBMPCorcompatible”来标识用户计算机

MediaLength

数值型

MediaLength@"IconTitle"存储的是指定图标中声音的时间长度或数字化电影的总帧数

MediaPlaying

逻辑型

当数字化电影、声音、视频信息在播放的时候，