内部库函数 - 图文(8)

szComponents

指定要显示的包含子部件的组件名称。子部件前面有复选框或单选钮。为显示所有顶层组件，给该参数传递一个空字符串（””）。

SdAskOptions在由系统变量MEDIA指定的文件媒体库或脚本创建组件组中查找所需组件。 nExclusiveFlag

指定你要在对话框中显示的按钮类型。在该参数位置传递下列预定义常量之一：

EXCLUSIVE：指定单选钮。 NONEXCLUSIVE：指定复选框。

如果你的安装包括必需的可见的组件，不要调用SdAskOptions来得到安装选项。而是，以非静止方式调

用

ComponentDialog,

SdComponentDialog,

SdComponentDialogAdv,

SdComponentMult

或

SdAskOptionsList。

必需组件可以这么理解：当活动组件（在组件窗格中被选择的组件）被安装时，你要添加组件到必须被安装的组件列表中或从该组件列表中删除组件。 其中控件有：

? ? ? ? 返回值：

NEXT (1)：表明单击了Next按钮。 BACK (12)：表明单击了Back按钮。 注解：

·你可以通过使用资源编辑器拷贝SdAskOptions对话框资源（位于_isres.dll），对拷贝作有限的修改，并给它一个唯一ID来创建多个SdAskOptions类型的对话框。当你调用SdAskOptions并在参数szId传递对话框的自定义拷贝时，自定义拷贝被显示。限制对存在的静态文本区作编辑修改和增加静态文本区。不建议添加需要处理程序的控件，因为它需要改变SdAskOptions的资源脚本。 5.4 SdAskOptionsList

语法：SdAskOptionsList (szTitle, szMsg, szComponents, nStyle);

说明：SdAskOptionsList函数创建一个对话框，显示一个自定义安装的组件列表。

SdAskOptionsList运行在由系统变量MEDIA指定的当前媒体上。在安装的初始化中，InstallShield给MEDIA赋缺省媒体名（“DATA”），它和你的文件媒体库（Data1.cab）相联系。为显示脚本创建的组件，按4.6中的相同步骤进行。

系统变量MEDIA的值在安装初始化过程中被设置为’DATA’。如果你改变该变量的值来指向一个脚本创建组件组，你必须在调用ComponentTransferData, CreateShellObjects, 或 CreateRegistrySet前将值修改回’DATA’。注意运行一个基于事件的脚本的安装中，ComponentTransferData被自动调用。

如果你的安装不使用一个安装类型对话框，你必须在调用SdAskOptionsList前调用ComponentSetupTypeSet来指定一个已经在IDE安装类型窗格中定义的安装类型。 参数： szTitle

指定对话框标题。为显示缺省标题（“选择组件”） ，给该参数传递一个空字符串（””）。 szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（””）。 szComponents

指定要显示的包含子部件的组件名称。为显示所有顶层组件，给该参数传递一个空字符串。

所需组件（列表框）：列出活动组件要求的组件。

组件（列表框）：列出所有定义的组件。活动组件有一个复选标记；所需组件有一个红圈和斜杠。 添加（按扭）：将在组件列表框中选定的组件添加到所需组件列表框中。 删除（按扭）：从所需列表框中删除选定的组件。

SdAskOptionsList在由系统变量MEDIA指定的文件媒体库或脚本创建组件组中查找所需的组件。 nStyle

指定最终用户的选择是否受限。在该参数位置传递下列预定义常量之一：

EXCLUSIVE：允许最终用户仅从列表中选择一个项目。如果任何szComponents’的子部件是所需组件，则不使用EXCLUSIVE模式。

NONEXCLUSIVE：允许最终用户从列表中选择多个项目，包括多个非邻接的选项。两个按钮被显示：Select All 和Clear All,，允许通过单击一个按钮选择所有选项或清除所有选项。 返回值：

NEXT (1)：表明单击了Next按钮。 BACK (12)：表明单击了Back按钮。 5.5 SdBitmap

语法：SdBitmap (szTitle, szMsg, szBitmap);

说明：SdBitmap函数在一个对话框中显示一个位图。位图所允许的最大大小是宽440个像素点、高275个像素点。仅当你使用一个资源编辑器来修改SdBitmap对话框资源使得显示消息的控件成为可见时，你才可以在SdBitmap对话框中显示一个消息，查看下面注解。 参数： szTitle

指定对话框标题。为显示缺省标题（“欢迎”） ，给该参数传递一个空字符串（””）。 szMsg

给该参数传递一个空字符串(“”)，除非你使用一个资源编辑器修改SdBitmap对话框来显示一个消息，查看下面注解。 szBitmap

指定要显示的位图的文件名和一组位图属性（可选）。如果包括位图属性，传递给该参数的字符串必须如下格式化：

“位图文件名；透明标志‘3-D标志；背景颜色” ?

位图文件名

指定位图文件名。如果文件名未限定（也就是说，如果它不包括一个驱动器指示符和路径），InstallShield在SUPPORTDIR查找该位图。 ?

透明标志

指示是否透明显示位图。当该标志是1（真）时，该位图所有紫红色（RGB值：255，0，255）部分都透明显示。该参数的缺省值是0（非透明）。 ? ?

3-D 标志

指示是否要绕着包含位图的静态区的边缘增加一个3-D边框。缺省为０（非３D边框）。 背景色

指示作为静态文本区背景的颜色。 注意该颜色仅当位图小于它所显示在的静态文本区或透明标志设置为1并且位图有透明区域时才会可见。背景色必须以RGB值表示，也就是三个由逗号分隔的数值型的值。 下面的例子将从MyBitmap.bmp文件显示位图，它位于SUPPORTDIR文件夹。该位图将被置于一个黑色背景上。它有一个3-D边框。该位图的任何紫红色的部分将被显示为背景色-黑色。 \返回值：

NEXT (1)：表明单击了Next按钮。 BACK (12)：表明单击了Back按钮。 注解：

·你可以使用一个资源编辑器来修改SdBitmap对话框资源，使得一个传递给参数szMsg的消息字符串在

SdBitmap对话框中显示。

·SdBitmap 对话框资源包括在_isres.dll中。该资源包含一个静态文本控件，它接收由参数szMsg传递的字符串。然而，该静态文本控件缺省为在SdBitmap对话框中不可查看（在对话框下）。SdBitmap也使用一个静态文本控件显示位图图象。你可以调整位图图象静态文本控件的大小和移动消息静态文本控件进入对话框来查看。

改变位图图象静态文本控制的大小可能影响你位图图象的显示。位图图象必须足够小来避免当它被SdBitmap在位图图象静态文本控制置中时被剪切掉。

·该函数不支持透明位图。如果你以该函数来使用一个透明位图，透明部分将被正常显示。 ·SdBitmap不支持图元文件。 5.6 SdComponentDialog

语法：SdComponentDialog (szTitle, szMsg, svDir, szComponents);

说明：使用SdComponentDialog函数创建一个对话框。显示当前媒体上用户可以安装的的组件列表和每个组件将占用的磁盘空间。该函数和SdComponentDialogAdv相同。

目标目录可以使用Browse按钮来修改；在其它驱动器上的可用磁盘空间可以使用Disk Space 按钮来检查。

SdComponentDialogt运行在由系统变量MEDIA指定的当前媒体上。在安装的初始化中，InstallShield给MEDIA赋缺省媒体名（“DATA”），它和你的文件媒体库（Data1.cab）相联系。为显示脚本创建的组件，按4.6中的相同步骤进行。

如果你的安装不使用一个安装类型的对话框，你必须在调用SdComponentDialog之前调用ComponentSetupTypeSet来指定一个已经在IDE安装类型窗格中定义的安装类型。

系统变量MEDIA的值在安装初始化过程中被设置为’DATA’。如果你改变该变量的值来指向一个脚本创建组件组，你必须在调用ComponentTransferData, CreateShellObjects, 或 CreateRegistrySet前将值修改回’DATA’。注意运行一个基于事件的脚本的安装中，ComponentTransferData被自动调用。 参数： szTitle

指定对话框标题。为显示缺省标题（“选择组件”） ，给该参数传递一个空字符串（””）。 szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（””）。 svDir

指定缺省选定的文件夹名；返回最终用户选择的文件夹名。注意由svDir指定的目标文件夹不会自动赋给TARGETDIR或其它任何系统变量。如果它要被使用，为将svDir值提供给安装，你必须将它赋给TARGETDIR或一个脚本定义的变量。

我们建议用户给该参数传递TARGETDIR而不是一个字符串变量。如果你在该参数不传递TARGETDIR，当最终用户在一个不同驱动器选择一个目标时显示在对话框的所需磁盘空间不会被重算。 szComponents

指定其子部件要被显示的组件名称。为显示所有主组件，给该参数传递一个空字符串(“”)。 SdComponentDialog在由系统变量MEDIA指定的文件媒体库或脚本创建组件组中查找所需的组件。 返回值：

NEXT (1)：表明单击了Next按钮。 BACK (12)：表明单击了Back按钮。 注解：

·一个组件在被选定前，其大小都显示为0。一旦它已经被选定，它的实际大小被显示。

·若有必要，组件名被截尾来允许显示最大可能的组件大小。显示大小的必要空间依赖于最大组件大小本身（2GB）、当前使用的组件大小选项、和用来在对话框显示组件信息的字体。组件大小选项由DialogSetInfo

函数设置。

·一旦显示最大可能大小所需的空间被确定，若有必要，所有组件名均自动被截尾以适应剩余空间。这确保组件名不会覆盖组件大小。

·注意在这种方法下需要较少空间显示大小（或没有被选）的组件的名称仍然会被截尾。为了最大化执行并确保组件名完整显示，使组件名小于在组件对话中的有效空间。

·如果由svDir指定的缺省文件夹不存在于最终用户系统，除非最终用户按下Browse按钮并按下列步骤从选择文件夹对话框创建它，否则它不会被创建。因此，无论何时用户想在调用ComponentTransferData(必要时，它会创建文件夹)前指定一个要使用的缺省文件夹，为了确定该文件夹是否存在，当SdComponentDialog返回时都必须调用ExistDir 。如果不存在，调用CreatDir在最终用户系统上创建它。

·运行在静止方式(silent mode )的安装，如果在调用SdComponentDialog前文件夹不存在，必须创建该新文件夹。这样可以确保确认对话框不被显示。没有这一步，需要两个响应文件来处理两个可能情况。 ·Disk Space按钮的ID是101。该按钮自动显示有效磁盘空间对话框。如果愿意你可以删除该按钮/选项。目录静态区需要一个ID为851。列表框ID有一个多选项风格。 5.7 SdComponentDialog2

语法：SdComponentDialog2 (szTitle, szMsg, szDir, szComponents);

说明：SdComponentDialog2函数创建一个对话框，显示一个用户可以安装的当前媒体上的组件列表。显示在组件窗口中的组件可以有子部件。如果一个组件有子部件，Change按钮将成为有效。单击Change按钮将生成选择子部件对话框，可以作进一步的选择。对每个组件和子部件，也提供说明。当用户选择或高亮显示组件时，其说明显示在对话框的说明区下。

SdComponentDialog2运行在由系统变量MEDIA指定的当前媒体上。在安装的初始化中，InstallShield给MEDIA赋缺省媒体名（“DATA”），它和你的文件媒体库（Data1.cab）相联系。为显示脚本创建的组件，按4.6中的相同步骤进行。

如果你的安装不使用一个安装类型的对话框，你必须在调用SdComponentDialog之前调用ComponentSetupTypeSet来指定一个已经在IDE安装类型窗格中定义的安装类型。

系统变量MEDIA的值在安装初始化过程中被设置为’DATA’。如果你改变该变量的值来指向一个脚本创建组件组，你必须在调用ComponentTransferData, CreateShellObjects, 或 CreateRegistrySet前将值修改回’DATA’。注意运行一个基于事件的脚本的安装中，ComponentTransferData被自动调用。 参数： szTitle

指定对话框标题。为显示缺省标题（“选择组件”） ，给该参数传递一个空字符串（””） szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（””）。 szDir

指定目标目录的名称（目标位置）。注意由svDir指定的目标文件夹不会自动赋给TARGETDIR或其它任何系统变量。如果它要被使用，为将svDir值提供给安装，你必须将它赋给TARGETDIR或一个脚本定义的变量。 szComponents

指定其子部件要被显示的组件名称。为显示所有主组件，给该参数传递一个空字符串(“”)。

SdComponentDialog2在由系统变量MEDIA指定的文件媒体库或脚本创建组件组中查找所需的组件。 返回值：

NEXT (1)：表明单击了Next按钮。 BACK (12)：表明单击了Back按钮。 注解：

·一个组件在被选定前，其大小都显示为0。一旦它已经被选定，它的实际大小被显示。

·若有必要，组件名称被截尾来允许显示最大可能的组件大小。显示大小的必要空间依赖于最大组件大小本身（2GB），当前使用的组件大小选项，和用来在对话框显示组件信息的字体。组件大小选项由DialogSetInfo函数设置。

·一旦显示最大可能大小所需的空间被确定，若有必要，所有组件名均自动被截尾以适应剩余空间。这确保组件名不会覆盖组件大小。

·注意在这种方法下需要较少空间显示大小（或没有被选）的组件的名称仍然会被截尾。为了最大化执行并确保组件名完整显示，使组件名小于在组件对话框中的有效空间。

·当且仅当被选定的组件有任何子部件时Change按钮才为有效。否则，它将变灰。

·如果一个组件被撤消选定，它的子部件也必须缺省为撤消选定。同样的，如果一个组件的所有子部件缺省为撤消选定，则父组件也必须缺省为撤消选定。有关组件和子部件的缺省选定设置请参考ComponentAddItem函数。

·当用户选定一个显示在对话框中的组件或子部件时，缺省选定设置被清除。如果用户撤消选定一个组件，所有它的子部件也将被撤消选定。如果用户撤消选定一个组件的所有子部件，该组件也将被撤消选定。 5.8 SdComponentDialogAdv

语法：SdComponentDialogAdv (szTitle, szMsg, svDir, szComponents);

说明：使用SdComponentDialogAdv函数创建一个对话框。显示当前媒体上用户可以安装的组件列表和每个组件将占用的磁盘空间。该函数和SdComponentDialog相同。

目标目录可以使用Browse按钮来修改：同时在其它驱动器上的可用磁盘空间可以使用Disk Space 按钮来检查。

SdComponentDialogtAdv运行在由系统变量MEDIA指定的当前媒体上。在安装的初始化中，InstallShield给MEDIA赋缺省媒体名（“DATA”），它和你的文件媒体库（Data1.cab）相联系。为显示脚本创建的组件，按4.6中的相同步骤进行。

如果你的安装不使用一个安装类型的对话框，你必须在调用SdComponentDialog之前调用ComponentSetupTypeSet来指定一个已经在IDE安装类型窗格中定义的安装类型。

系统变量MEDIA的值在安装初始化过程中被设置为’DATA’。如果你改变该变量的值来指向一个脚本创建组件组，你必须在调用ComponentTransferData, CreateShellObjects, 或 CreateRegistrySet.前将值修改回’DATA’。注意运行一个基于事件的脚本的安装中，ComponentTransferData被自动调用。 参数： szTitle

指定对话框标题。为显示缺省标题（“选择组件”） ，给该参数传递一个空字符串（””）。 szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（””）。 svDir

指定缺省选定的文件夹名；返回最终用户选择的文件夹名。注意由svDir指定的目标文件夹不会自动赋给TARGETDIR或其它任何系统变量。如果它要被使用，为将svDir值提供给安装，你必须将它赋给TARGETDIR或一个脚本定义的变量。

我们建议用户给该参数传递TARGETDIR而不是一个字符串变量。如果你在该参数不传递TARGETDIR，当最终用户在一个不同驱动器选择一个目标时显示在对话框的所需磁盘空间不会被重算。 szComponents

指定其子部件要被显示的组件名称。为显示所有主组件，给该参数传递一个空字符串(“”)。

SdComponentDialogAdv在由系统变量MEDIA指定的文件媒体库或脚本创建组件组中查找所需的组件。 返回值：

NEXT (1)：表明单击了Next按钮。 BACK (12)：表明单击了Back按钮。

百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说综合文库内部库函数 - 图文(8)在线全文阅读。