InstallShield 2016 » InstallScript Language Reference
Project • This information applies to the following project types:
| • | InstallScript |
| • | InstallScript MSI |
The SdShowMsg function provides a simple way to display an informative message that remains on screen while script processing continues.
The SdShowMsg function opens or closes a small modeless window that displays the message specified by szMsg. When bShow is TRUE, the window is opened, the message is displayed in the window, and processing continues with the next statement in the script. Note that the SdShowMsg window is positioned at the center of the setup window. When bShow is FALSE, szMsg is ignored and the SdShowMsg window is closed.
Note • When the SdShowMsg window is open, subsequent calls to SdShowMsg with TRUE in the second parameter are ignored. To change the message, you must first close the window by calling SdShowMsg with FALSE in the second parameter and then call SdShowMsg again with the new message in szMsg and TRUE in the second parameter.
Syntax
SdShowMsg ( szMsg, bShow );
Parameters
|
Parameter |
Description |
||||||
|
szMsg |
Specifies the message to display in the window. To display the default message (“Setup is searching for installed features”), pass a null string (“”) in this parameter. This parameter is ignored when bShow is FALSE. SdShowMsg is designed to display a message on a single line. Do not embed newline characters (\n) in szMsg. Note • The SdShowMsg window is sized horizontally to display the value of szMsg on a single line. If the length of the message exceeds the maximum width of the window, the message is truncated to fit the window. |
||||||
|
bShow |
Specifies whether to open or close the window. Pass one of the following predefined constants in this parameter:
|
Return Values
This function always returns 0.
Additional Information
| • | The dialog that is displayed by the SdShowMsg function cannot be displayed with a skin; it appears the same regardless of whether you have specified a skin. |
| • | The Dialog Editor does not support dialogs, such as SdShowMsg, that do not have a title bar. Therefore, this dialog is not displayed in the Dialogs view as one of the dialogs that you can edit. To customize this dialog, use the SdShowMsg call. |
See Also
InstallShield 2016 Help LibraryMay 2017 |
Copyright Information | Flexera Software |