内部库函数 - 图文(2)

2.5 PlaceWindow

语法：PlaceWindow (nObject, nDx, nDy, nCorner);

说明：PlaceWindow函数改变用户界面对象的位置，包括布告牌。用nDx和nDy指定对象的边与屏幕边缘的距离。 参数： nObject

指定要被改变位置的对象。在该参数位置传递下列预定义的常量之一：

BACKGROUND：移动背景窗口。

BILLBOARD：设置在文件传输过程中使用的布告牌的位置。

MMEDIA_AVI：设置要播放的下一个AVI文件的窗口位置。缺省时，AVI文件将在InstallShield客户窗口的左边位置窗口中播放，从左起10个像素点，从上起10个像素点。

STATUS：移动进度指示器。

STATUSDLG：移动对话框风格的进度指示器。 STATUSEX：移动安装状态对话框。 STATUSOLD：移动旧风格的进度指示器。

当你调用PlaceWindow来移动进度指示器或者状态对话框时，确信为你在安装中激活的反馈对象传递了正确常量。例如，如果你调用了Enable(STATUSOLD),则你必须传递STATUSOLD给PlaceWindow。 nDx

以像素点指定对象的边与屏幕边缘之间的水平距离。 nDy

以像素点指定对象的边与屏幕边缘之间的垂直距离。 nCorner

指定用nDx和nDy表示的距离是从哪个角度量所得。在该参数位置传递下列预定义的常量之一：

LOWER_LEFT：从InstallShield主窗口的左边度量得nDx，从底端度量得nDy。 LOWER_RIGHT：从InstallShield主窗口的右边度量得nDx，从底端度量得nDy。 UPPER_LEFT：从InstallShield主窗口的左边度量得nDx，从顶端度量得nDy。 UPPER_RIGHT：从InstallShield主窗口的右边度量得nDx，从顶端度量得nDy。 返回值：

0：表明函数成功改变了对象的位置。 < 0：表明函数未能改变对象的位置。 注解：

·使用该函数时要意识到一个安装程序要运行在不同的屏幕分辨率下。你在放置对象前可能要确定屏幕范围。距离以像素点度量，是对象边缘与指定的屏幕角落边缘之间的距离。

·用户不能用该函数定位消息框，因为消息框是由本机的Windows/PM API创建。一个消息框的位置由Windows/PM确定，而不是在InstallShield控制之下。另外，用户不能用该函数定位一个自定义对话框。 2.6 PlayMMedia

语法：PlayMMedia (nType, szFileName, nOperation, nReserved);

说明： PlayMMedia函数播放一个声音或AVI文件。MIDI或WAVE类型的声音文件和AVI(视频)文件既可以以同步方式也可以以异步方式播放。该函数也可以被用来连续播放一个文件。为了实现这个目的，一个标志可被按位或，来指示该文件以连续方式被播放。

由于 AVI文件早被压缩而且往往大于1.4MB的软盘，因此,视频显示推荐于光盘安装。 参数： nType

指定文件类型。在该参数位置传递下列预定义的常量之一：

MMEDIA_WAVE：文件是WAVE声音格式。 MMEDIA_MIDI：文件是MIDI声音格式。 MMEDIA_AVI：文件是一个AVI文件。 szFileName

指定要播放的声音/AVI文件的全限定名。 nOperation

指定播放方式。在该参数位置传递下列预定义的常量：

MMEDIA_PLAYSYNCH：同步播放。

MMEDIA_PLAYASYNCH：异步播放。该常量可以用或运算符（|）与MMEDIA_PLAYCONTINUOUS组合使用。

MMEDIA_PLAYCONTINUOUS：连续循环播放。当以同步方式播放一个声音/AVI文件时不能使用该值。它只使用于以异步方式播放的文件。用或运算符（|）将它与MMEDIA_PLAYASYNCH组合使用。

MMEDIA_STOP：停止播放。 nReserved

给该参数传递0值，不允许其他值。 返回值：

0：表明函数成功播放文件。 < 0：表明函数不能播放文件。 2.7 RGB

语法：RGB (constRed, constGreen, constBlue);

说明：RGB函数创建一个自定义颜色值，该颜色可被SetColor和SetTitle使用。 参数： constRed

指定一个数值型常数，值域为0..255，指示在自定义色中红色的数量。 constGreen

指定一个数值型常数，值域为0..255，指示在自定义色中绿色的数量。 constBlue

指定一个数值型常数，值域为0..255，指示在自定义色中蓝色的数量。 返回值：

该函数返回一个调用SetColor和SetTitle时可被使用的自定义颜色的数值。 2.8 SetColor

语法：SetColor (nObject, nColor);

说明：SetColor函数设置主安装窗口的背景色。 参数： 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：改变警告风格的消息框的标题。

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);

说明：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

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

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函数为进度指示器（状态条）设置完成指示器的百分比的初始值或当前值，并指定在进度指示器（状态条）最高行显示的当前消息。

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