Authorware类和函数:authorware7.0函数教学文章连载--Icons类(1)

childidtonum

语法：number:=childidtonum（iconid@ "parenttitle "，@ "childtitle " [，flag]）]

说明：返回子图标在父图标下的序号（父图标一般为【群组】设计图标、【框架】设计图标、【交互作用】设计图标、【决策判断】设计图标，子图标为父图标的附属设计图标，按照从上到下、从左到右的顺序排序）。如果childtitle不在parenttitle之下，该函数返回0。当parenttitle为【框架】设计图标时，使用参数flag要求该函数返回childtitle在【框架】设计图标parenttitle之下或其入口、出口窗格中的位置。flag可以取以下数值：

0—默认值，返回childtitle在【框架】设计图标parenttitle的第几页中

1—返回childtitle在【框架】设计图标parenttitle的入口窗格中的位置（从上到下排序）

2—返回childtitle在【框架】设计图标parenttitle的出口窗格中的位置（从上到下排序）

childnumtoid

语法：id:=childnumtoid（iconid@ "parent "，n [，flag]）

说明：返回指定父图标parent下第n个子图标的id号码。父图标、子图标及参数flag的定义见函数childidtonum（）的说明。

displayicon

语法：displayicon（iconid@ "icontitle "）

说明：按照设计图标属性检查器中的设置，显示指定的设计图标中的内容。如果该设计图标已经显示在屏幕上，则会更新其中变量的值。例如，文本对象中的变量或者设计图标属性中使用的变量。

displayiconnoerase

语法：displayiconnoerase（iconid@ "icontitle "）

说明：显示指定的设计图标，其结果正如将该设计图标设置为“prevent automatic erase”方式。

eraseall

语法：eraseall（ ）

说明：擦除【演示】窗口中的所有显示内容。

eraseicon

语法：eraseicon（iconid@ "icontitle "）

说明：删除指定的设计图标中的所有显示对象。

getmovieinstance

语法：identifier:=getmovieinstance（iconid@ "movietitle "）

说明：返回一个quicktime或avi数字化电影实例在authorware中的数字标识，参数movietitle是播放数字化电影的【数字化电影】设计图标名称。

iconfirstchild

语法：id:=iconfirstchild（iconid@ "icontitle " [，flag]）

说明：返回指定设计图标的第一个子图标的id号码，【群组】设计图标的子图标由前向后进行计数，分支结构中的子图标由左向右进行计数。如果指定设计图标没有子图标，该函数返回0。参数flag的取值如下：

0—返回指定设计图标的第一个子图标的id号码（默认情况）

1—返回指定【框架】设计图标入口窗格中第一个设计图标的id号码

2—返回指定【框架】设计图标出口窗格中第一个设计图标的id号码

iconid

语法：number:=iconid（"icontitle "）

说明：返回指定设计图标的id号码。该函数影响系统变量evalstatus的值。

iconlastchild

语法：id:=iconlastchild（iconid@ "icontitle " [，flag]）

说明：与函数iconfirstchild作用相似，但是返回位于最后的子图标的id号码。

iconlogid

语法：number:=iconlogid（n）

说明：返回当前正在执行的设计图标之前第n个设计图标的id号码。如果n=0，返回当前执行的设计图标的id号码。在使用该函数之前，必须将系统变量iconlog设置为“大于0”的值。

iconlogtitle

语法：string:=iconlogtitle（n[，m]）

说明：返回当前正在执行的设计图标之前第n个设计图标的名称。如果n=0，返回当前执行的设计图标的名称。如果使用了参数m，则返回在n和m之前所有设计图标的名称。在使用该函数之前，必须将系统变量iconlog设置为“大于0”的值。

iconnext

语法：id:=iconnext（iconid@ "icontitle "）

说明：在一个【群组】设计图标中，该函数返回指定设计图标的下一个设计图标的id号码。如果指定设计图标已经是最后一个，则函数返回0。当用在一个分支结构中时，该函数返回指定设计图标右边的设计图标的id号码，如果指定设计图标已经是分支结构中最右一个，则函数返回0。

iconnumchildren

语法：number:=iconnumchildren（iconid@ "icontitle " [，flag]）

说明：返回指定设计图标包含（或附属）的子图标总数。参数flag的取值如下：

0—返回指定设计图标的子图标总数（默认情况）

1—返回【框架】设计图标入口窗格中设计图标总数

2—返回【框架】设计图标出口窗格中设计图标总数

iconparent

语法：id:=iconparent（iconid@ "icontitle "）

说明：返回指定设计图标的父图标的id号码。可以作为父图标的设计图标有：【群组】设计图标、【框架】设计图标、【交互作用】设计图标和【决策判断】设计图标。

iconprev

语法：id:=iconprev（iconid@ "icontitle "）

说明：与函数iconnext相似，但是返回前一个子图标的id号码。当指定设计图标之前没有任何设计图标时，该函数返回0。

icontitle

语法：string:=icontitle（iconid）

说明：返回由id号码iconid指定的设计图标的名称，标题中包含的注释也一并返回。

icontitleshort

语法：string:=icontitleshort（iconid）

说明：与icontitle作用相似，但是返回的标题中不包含注释。

icontype

语法：number:=icontype（iconid@ "icontitle "）

说明：返回以数值表示的设计图标的类型。返回值为0~15之间的数值，与设计图标类型的对应关系如下：

0—无效id号码

1—【显示】设计图标

2—【移动】设计图标

3—【擦除】设计图标

4—【交互作用】设计图标

5—【决策判断】设计图标

6—【群组】设计图标

7—【等待】设计图标

8—【运算】设计图标

9—【数字化电影】设计图标

10—【声音】设计图标

11—【dvd】设计图标

12—【框架】设计图标

13—【导航】设计图标

14—【sprite】设计图标

15—【知识对象】设计图标

icontypename

语法：string:=icontypename（n）

说明：返回与数值n对应的设计图标类型描述，n与类型描述的对应关系如下：

1—display

2—motion

3—erase

4—interaction

5—decision

6—map

7—wait

8—calc

9—movie

10—sound

11—video

12—framework

13—navigate

14—sprite

15—knowledge object