07 InstallShield内部库函数全集七-组件函数（中文版）

显示组件之前，你可以使用ComponentSelectItem 来修改选定状态，而且以后你可以根据你的需要使用它来修改或覆盖选择。 参数：

szComponentSource

指定其选定状态要被设置的组件所属文件媒体库或脚本创建组件集的媒体名。 szComponent

指定其选定状态要被设置的组件。 bSelected

指定组件是否要被选定或撤消选定。在该参数位置传递下列预定义常量之一： TRUE：选定指定的组件。 FALSE：撤消选定指定的组件。 返回值：

0：ComponentSelectItem成功设置项目的选定状态。

< 0：ComponentSelectItem未能设置项目的选定状态。调用ComponentError查看附加信息。 7.17 ComponentSetData

语法：ComponentSetData (szComponentSource, szComponent, nInfo, nData, szData); 说明：ComponentSetData 函数为指定的组件设置属性和数据。对多数部分，设置和在组件属性窗口中的域设置相一致，从InstallShield IDE中的组件窗格中可达。注意一些域不能为脚本创建的组件组设置。 参数：

szComponentSource

指定其属性和数据要被设置的组件所属文件媒体库或脚本创建组件集的媒体名。 szComponent 指定组件名。

nInfo

指定要被设置的信息类型。在该参数位置传递下列预定义常量之一：

COMPONENT_FIELD_DESCRIPTION：该文本被显示在组件选择对话框中的说明域。 COMPONENT_FIELD_FTPLOCATION：一个FTP位置。 COMPONENT_FIELD_HTTPLOCATION：一个HTTP位置。.

COMPONENT_FIELD_STATUS (不适用与脚本创建组件)：文件传输过程中该文本被显示在进度指示器中。

COMPONENT_FIELD_VISIBLE：指示该组件是否可见。参数nData可为下列数之一： TRUE：组件可见。 FALSE：组件不可见。

COMPONENT_FIELD_SELECTED：设置组件的选定状态。该设置和ComponentSelectItem的效果一样。参数nData可以是下列数之一： TRUE：选定该组件项目。 FALSE：撤消选定该组件项目。

COMPONENT_FIELD_SIZE (不对文件媒体库)：组件的总的原始文件大小。 COMPONENT_FIELD_MISC：杂项文本。

COMPONENT_FIELD_DISPLAYNAME：确定在组件选择对话框中显示的组件名。

COMPONENT_FIELD_CDROM_FOLDER（不对脚本创建的组件组）：仅对CD-ROM分布媒体库。CD上的组件数据的定位。

COMPONENT_FIELD_IMAGE：覆盖一个组件的缺省图标赋值。在nData传递显示的图标的索引。为指示组件不显示图标，在nData传递-1。 nData

当由nInfo指示的信息是数值时，指定一个数值型值。 szData

当由nInfo指示的信息是字符串时，指定一个字符串值。 返回值：

0：ComponentSetData成功。

< 0：ComponentSetData失败。调用ComponentError查看附加信息。 7.18 ComponentSetTarget

语法：ComponentSetTarget (szMediaLibrary, szPropertyVar, szLocation);

说明：ComponentSetTarget 函数将szLocation的值赋给由szPropertyVar指定的属性变量。属性变量可以在文件组窗口的Destionation域中和简捷属性窗口的Target域中使用。SzLocation的值必须是一个完整路径（包含驱动器字母和冒号）或一个部分路径，依赖于szPropertyVar 如何被使用。你必须确认szLocation是路径表达式的正确形式。在调用ComponentTransferData之前调用ComponentSetTarget 。 该函数不能被使用到脚本创建的组件组。 参数： szMediaLibrary

指定要设置其用户定义的变量的文件媒体库的媒体名。 szPropertyVar

指定用户定义的变量。在InstallShield IDE中，用户定义的变量用<变量名>的格式。将用户定义的变量表示为一个字符串，包含中括号。例如： szPropertyVar = \szLocation

指定路径表达式来代替用户定义的变量。该字符串必须包含附加引号，即使它指定一个长路径。 返回值： 该函数总返回0。

7.19 ComponentSetupTypeEnum

语法：ComponentSetupTypeEnum (szMediaLibrary, listSetupTypes);

说明：ComponentSetupTypeEnum 函数列举所有和指定媒体相联系的安装类型。这些安装类型可以由你在IDE中定义并保存在文件媒体库中。ComponentSetupTypeEnum 不能工作在脚本创建的组件组上。你必须使用ListCreat函数创建listSetupTypes字符串列表。 参数： szMediaLibrary

指定安装类型要被列举的文件媒体库的媒体名。 listSetupTypes

返回一个在指定媒体上的所有安装类型的列表。由listSetupType标识的字符串列表必须已通过调用ListCreate被初始化。 返回值：

0：ComponentSetupTypeEnum成功。 < 0：ComponentSetupTypeEnum失败。 7.20 ComponentSetupTypeGetData

语法：ComponentSetupTypeGetData (szMediaLibrary, szSetupType, nInfo, nvResult, svResult); 说明：ComponentSetupTypeGetData函数检索和一个指定的安装类型相联系的数据。然后你可以任意使用该数据。该函数不能被使用到脚本创建的组件组。 参数： szMediaLibrary

指定文件媒体库的媒体名，从该库中检索和一个安装类型相关联的数据。 szSetupType

指定安装类型名。该名必须指定为和显示在InstallShield IDE中的完全一样，例如，”典型”。 nInfo