InstallShield函数详解：界面与信息操作

需积分: 9 43 浏览量更新于2024-07-20 收藏 2.61MB PDF 举报

InstallShield 是一款广泛应用于软件开发的高级安装包制作工具，它提供了一系列丰富的内部库函数，使得开发者能够轻松构建复杂的安装流程和用户交互界面。这些函数分布在不同的类别下，如用户界面、信息获取、对话框操作等，以满足不同阶段的安装需求。 1. **用户界面函数**：这部分函数用于控制和定制安装过程中的窗口和图形显示。例如，`Disable` 和 `Enable` 可以用来控制控件的启用或禁用状态；`FindWindow` 用于查找特定的窗口；`PlaceBitmap` 和 `PlaceWindow` 负责放置图像和窗口的位置；`PlayMMedia` 播放媒体文件，增强用户体验；颜色和字体设置函数（如 `RGB`, `SetColor`, `SetFont`）确保了界面的一致性和可读性；`SetTitle` 和 `SizeWindow` 控制窗口的标题和大小；`StatusUpdate` 用于更新安装状态信息。 2. **信息函数**：主要涉及获取系统和环境信息，如磁盘空间（`GetDiskSpace` 和 `GetDiskSpaceEx`）、环境变量（`GetEnvVar`）、内存可用量（`GetMemFree`）、系统配置（`GetSystemInfo`），以及有效驱动器列表（`GetValidDrivesList`）和窗口句柄（`GetWindowHandle`）。这些信息对于安装过程中的决策和错误处理至关重要。 3. **内部对话框函数**：包括引导用户输入路径（如 `AskDestPath`）、选择文件或目录（`AskPath`, `SelectDir`, `SelectFolder`）、确认选项（`AskOptions`, `AskYesNo`）、组件对话框（`ComponentDialog`）等，以及自定义对话框（如 `SprintfBox` 和 `Welcome` 对话框）。这些函数确保了安装过程中用户的交互体验，并能收集必要的用户输入。 4. **Sd对话框函数**：这部分是特别针对InstallShield的Sd（Scripting Dialogs）功能，提供了更高级别的对话框定制和管理功能，如设置对话框信息（`DialogSetInfo`）、定制询问路径和选项的对话框（`SdAskDestPath` 和 `SdAskOptions`）等。通过利用这些内置函数，开发者可以灵活地设计安装过程，确保安装的稳定性和用户体验。了解和熟练运用这些函数是使用InstallShield进行高效软件打包安装的关键。在编写安装脚本时，应根据具体需求选择合适的函数，并注意遵循良好的编程实践，以避免潜在的问题和错误。

Installshield 函数

nObject

指定要改变的用户界面对象。在该参数位置传递下列预定义的常量：

BACKGROUND

指示安装窗口的背景。缺省颜色为纯深青色（solid teal）： RGB(0,128,128)。

nColor

为背景指定一种颜色。

对于一种过渡背景色，可传递下列常量之一：

BK_BLUE、BK_GREEN、BK_MAGENTA、BK_ORANGE

BK_PINK、BK_RED、BK_YELLOW

对于一种纯背景色，可传递下列常量之一：

BK_SOLIDBLACK、BK_SOLIDBLUE、BK_SOLIDGREEN、BK_SOLIDMAGENTA

BK_SOLIDORANGE、BK_SOLIDPINK、BK_SOLIDRED、BK_SOLIDWHITE

BK_SOLIDYELLOW

对于一种自定义颜色，可在该参数位置传递 RGB 函数。

为了在使用自定义颜色绘制背景时得到光滑的效果（过渡），可将该颜色与预定义常量 BK_SMOOTH 按位或。注意当 256 色有效时

光滑效果将更好。

返回值：

0：表明函数成功设置对象的颜色。

< 0：表明函数未能设置用户界面对象的颜色。

注解：

·当使用一个 RGB 值时，你可以应用 Microsoft Windows 的编程指南中描述的相同的方法。

你可以指定 RED、GREEN、BLUE 颜色的混合来“混合”颜色。用从 0 到 255 的数之一来表示使用颜色的数量。在 RGB 宏中的参数

必须使用字面数值。你可以使用一个表示 RGB 颜色的长整型数来代替 RGB 语句。

2.9 SetDialogTitle

语法：SetDialogTitle (nDialogId, szTitle);

说明：SetDialogTitle 函数改变显示在一些公用内部对话框标题栏的标题。用参数 nDialogId 指定对话框。如果你不使用

SetDialogTitle，InstallShield 显示缺省标题。一旦你为某一特定对话框设置了标题，除非你再次使用 SetDialogTitle 改变标题，

否则 InstallShield 在每一个该类型对话框的实例中都使用该标题。

参数：

nDialogId

标识标题要被改变的内部对话框。在该参数位置传递下列预定义常量之一：

DLG_ASK_OPTIONS：改变 AskOptions 对话框标题。

DLG_ASK_PATH：改变 AskPath 对话框标题。

DLG_ASK_TEXT：改变 AskText 对话框标题。

DLG_ASK_YESNO：改变 AskYesNo 对话框标题。

DLG_ENTER_DISK：改变 EnterDisk 对话框标题。

DLG_MSG_INFORMATION：改变信息风格的消息框的标题。

DLG_MSG_SEVERE：改变严重警告风格的消息框的标题。

DLG_STATUS：改变对话风格进度指示器的标题。在带 DLG_STATUS 选项调用 SetDialogTitle 后，为了使标题修改有效，你必须

通过调用 Enable(STATUSDLG)来重新激活该对话风格进度指示器。

DLG_MSG_WARNING：改变警告风格的消息框的标题。

Installshield 函数

DLG_USER_CAPTION：当你使用用户定义的消息框风格时改变消息框的标题。

szTitle

指定新标题。

返回值：

0：表明函数成功修改了对话框标题。

< 0：表明函数未能修改对话框标题。

注解：

·你必须为每种你希望修改其标题的对话框分别调用 SetDialogTitle。

·InstallShield 使用标准 Windows 消息框函数创建消息框。Windows 为这些消息框确定 Ok 和 Cancel 按扭文字。InstallShield

不能控制在 Windows 消息框中使用的按扭文字。

2.10 SetDisplayEffect

语法：SetDisplayEffect (nEffect);

说明：SetDisplayEffect 函数指定用 PlaceBitmap 函数显示位图文件或图元文件时使用的显示效果。一旦显示效果被设定，所有随

后由 PlaceBitmap 显示的位图文件将一直使用该效果显示，直到另一个对 SetDisplayEffect 的调用来设定一个新的显示效果。

参数：

nEffect

指定一个显示效果。在该参数位置传递下列预定义的常量之一。注意这些常量具有互斥性；它们相互之间不能使用按位或。而且，当

用 PlaceBitmap 显示一个位图文件时指定了 BITMAPICON、 FULLSCREEN、 FULLSCREENSIZE 或 TILED 时该参数无效：

EFF_FADE：位图或布告牌淡入淡出。

EFF_REVEAL：位图或布告牌逐渐从中央向四周填充。

EFF_HORZREVEAL：位图或布告牌从它的中央逐渐水平滚动出来。

EFF_HORZSTRIPE：位图或布告牌的一部分从外往里水平填充，然后剩余部分从中央部分往外填充。

EFF_VERTSTRIPE：位图或布告牌的一部分从外往里垂直填充，然后剩余部分从中央部分往外填充。

EFF_BOXSTRIPE：位图或布告牌的一部分从四周向里填充，剩余部分向四周填充。

EFF_NONE：该选项是缺省设置。使用它来清除调用其它任一选项后的显示效果。

只有 EFF_REVEAL 和 EFF_HORZREVEAL 可用于图元文件。

返回值：

0：表明函数成功设置显示效果。

< 0：表明函数未能设置显示效果。

注解：

·当位图是由 PlaceBitmap 带选项 BITMAPICON、FULLSCREEN、FULLSCREENSIZE 或 TILED 显示时，该位图不会按显示效果

显示，而是正常显示。更多的信息可查阅 PlaceBitmap。

·显示效果仅当放置位图时出现，当删除位图时不能使用显示效果。

·只有展示（EFF_REVEAL）和水平展示（EFF_HORZREVEAL）效果可用于图元文件。

2.11 SetErrorMsg

语法：SetErrorMsg (nErrorID, szText);

Installshield 函数

说明：SetErrorMsg 函数定制 InstallShield 缺省错误信息。你可以使用该函数来指定显示这些错误信息的消息框的标题文本。

参数：

nErrorID

指定要替换的错误信息。在该参数位置传递下列预定义的常量之一：

ERR_BOX_BADPATH：当 EnterDisk 检测到一个由用户输入的错误路径时显示该信息。

ERR_BOX_BADTAGFILE：当 EnterDisk 检测到指定的标签文件不存在于磁盘上时显示该信息。

ERR_BOX_DISKID：当 EnterDisk 检测到由用户指定的驱动器不存在时显示该信息。

ERR_BOX_DRIVEOPEN：当 EnterDisk 检测到磁盘驱动器未关闭时显示该信息。

szText

指定要在消息框中显示的错误信息。

返回值：

0：表明函数成功改变错误信息。

< 0：

表明函数未能改变错误信息。

2.12 SetErrorTitle

语法：SetErrorTitle (nErrorID, szText);

说明：SerErrorTitle 函数指定 InstallShield 内部错误消息框标题栏的自定义文本。你可以使用该函数来自定义错误消息文本。

参数：

nErrorID

指定标题要被替换的错误消息框。在该参数位置传递下列预定义的常量之一：

ERR_BOX_BADPATH：当 EnterDisk 检测到错误路径时显示该消息。

ERR_BOX_BADTAGFILE：当 EnterDisk 检测到指定的标签文件不存在于磁盘上时显示该消息。

ERR_BOX_DISKID：当 EnterDisk 检测到指定的驱动器不存在时显示该消息。

ERR_BOX_DRIVEOPEN：当 EnterDisk 检测到磁盘驱动器未关闭时显示该消息。

szText

指定显示在错误消息框中的标题。

返回值：

0：表明函数成功修改了标题栏的文本。

< 0：表明函数未能修改标题栏的文本。

2.13 SetFont

语法：SetFont (nItemID, nFontStyle, szFontName);

说明：SetFont 函数设置显示的正文串的字体和风格。你可以在该函数使用标准 Windows

字体。

参数：

nItemID

指定其字体和字体风格要被设置的项。在该参数位置传递下列预定义的常量：

Installshield 函数

FONT_TITLE：指定安装过程的主标题，该主标题显示在安装窗口的左上角。

nFontStyle

指定字体风格。在该参数位置传递下列预定义的一个或多个常量。除 STYLE_NORMAL 之外的所有常量可以用按位或来指定多种风格：

STYLE_NORMAL：没有加粗、倾斜或阴影（不能被按位或）。

STYLE_BOLD：字体加粗。

STYLE_ITALIC：字体倾斜。

STYLE_SHADOW：字体有阴影底纹。

STYLE_UNDERLINE：加下划线。

szFontName

指定一个有效的 Windows 字体的名称。有效的字体名称包括 Courier, Helv, Helvetica, Modern, Roman, Script, Terminal,

Times 和 TmsRmn。如果指定的字体没有找到指定的风格，就使用 Arial。

返回值：

0：表明函数成功设置字体。

< 0：表明函数未能设置字体。

2.14 SetStatusWindow

语法：SetStatusWindow (nPercent, szString);

说明：SetStatusWindows 函数为进度指示器（状态条）设置完成指示器的百分比的初始值或当前值，并指定在进度指示器（状态条）

最高行显示的当前消息。

通过调用 ComponentTransferData 或 ComponentMoveData 来传输文件的安装必须在文件传输开始之前调用

SetStatusWindows，这是为了设置完成指示器百分比为 0%而且清除指示器最高行。不再需要另外调用 SetStatusWindows。每

一个组件的文件被装入时，该组件的 ‘状态文本’字符串会在状态条最高行自动显示。

使用 CopyeFile 或 XcopyFile 函数装入文件的安装程序在相继调用 CopyFile 或 XcopyFile 之间，可能需要多次调用

SetStatusWindows 来改变指示器最高行的信息。

在传输文件前，你的安装程序还应该调用 StatusUpdate 函数激活文件传输过程中百分比完成指示器的自动更新。为了使得在状

态条第二行显示正被安装文件的名称和路径，需在传输文件前带参数 INDVFILESTATUS 来调用 Enable 函数。在这些调用后，百分

比完成指示器在文件传输过程中被平滑更新，每个文件的文件名在被传输时将显示。

参数：

nPercent

指定 0 到 100 之间的一个数值来表示百分比完成指示器显示的百分比。若要改变显示在状态条最高行的信息而不改变百分比完成指示

器，则指定该参数为-1。

szString

指定显示在状态条最高行的字符串。注意如果一个'DisplayText' 参数已被指定给该组件（在 IDE 中），那么当调用

ComponentTransferData 时该字符串将自动改写任何该参数指定的文本。

返回值：该函数没有返回值。

2.15 SetTitle

语法：SetTitle (szTitle, nPointSize, nColor);

Installshield 函数

说明：SetTitle 函数根据 nColor 的值在主窗口标题栏或在主窗口内显示一个标题。

参数：

szTitle

指定在主窗口标题栏或主窗口内显示的一个标题。如果标题要显示在窗口的标题栏，你必须在第三个参数位置指定预定义常量

BACKGROUNDCAPTION。如果一个标题栏的标题不符合可用空间，那将被从右截尾并以省略号终止。缺省标题栏标题为“安装”。

当给第三个参数传递一个颜色值时，标题在主窗口的顶端左对齐显示。相对主窗口太宽的标题将被从右截尾显示。为创建一个占据多

行的标题，可在你希望的行断开处嵌入换行符。

nPointSize

以点数来指定一个在主窗口显示的标题的字号。建议字号为 24 点数。注意当第三个参数为 BACKGROUNDCAPTION 时该参数被忽

略。

nColor

指定一个颜色或预定义常量 BACKGROUNDCAPION。为指示 szTitle 值应该在主窗口标题栏显示，则在该参数位置传递预定义的常

量 BACKGROUNDCAPTION。当用户指定了 BACKGROUNDCAPTION，nPointSize 被忽略；标题栏标题的颜色和字号将由最终用

户的系统设置决定。注意该选项在不运行在窗口模式的安装程序中无效；请查看下面的注解。

为指示 szTitle 值应该在主窗口中显示，通过在该参数位置传递下列预定义的常量之一来指定该标题的颜色：BLACK，BLUE，GREEN，

MAGENTA，RED，YELLOW 或 WHITE。用户也可以在该参数位置传递 RGB 函数来指定自定义颜色，如下面例子所示：

SetTitle("FantasticApp", 24, RGB(78, 125, 161));

返回值：

0：表明函数成功设置安装的标题。

< 0：表明函数未能设置安装的标题。

注解：

·不运行于窗口模式下的安装中，第三个参数设置为 BACKGROUNDCAPTION 时调用 SetTitle 无效。为在一个标准窗口中运行安装

程序，你必须首先以参数 DEFWINDOWMODE 或 FULLWINDOWMODE 来调用 Enable，然后以参数 BACKGROUND 调用 Enable

来显示窗口。

·用 SetColor 来设置你安装的背景色。

·用 SetFont 来设置在背景窗口中显示的标题的字体和字体风格。

2.16 SizeWindow

语法：SizeWindow (nObject, nDx, nDy);

说明：使用 SizeWindow 函数来改变一个特定用户界面元件的大小。以像素点来指定新的

大小。

参数：

nObject

指定要调整大小的对象。在该参数位置传递下列预定义的常量之一：

BACKGROUND：标识为主背景窗口。

METAFILE：标识为在文件传输过程中使用的布告牌。SizeWindow 不支持位图文件（.bmp）。该参数对用 SdBitmap 函数显示的图

元文件不起任何作用。SdBitmap 自动调整被显示的图元文件的大小。

MMEDIA_AVI：设置播放下一个 AVI 文件的窗口的大小。所有 AVI 视频以一个缺省大小来显示。改变大小可能会改变视频的有效分

辨率和明快度。

nDx

以像素点指定对象的水平大小。

nDy

剩余198页未读，继续阅读

_HERO_

粉丝: 2
资源: 18

InstallShield函数详解：界面与信息操作

InstallShield函数手册CHM格式

installshield 函数大全(中文）

installshield函数

InstallShield函数库

installshield函数大全

installshield函数库大全（中文）

InstallShield函数详解：创建与管理程序文件夹及图标操作

installshield内部函数

installshield内部函数库

Installshield 教程 函数库

最新资源

Installshield 教程函数库