Summary

Synopsis

This article discusses how to change the static text in a custom or Sd dialog box.

Discussion

The CtrlSetText function is provided for changing static text dynamically in a custom dialog box.

This function can also be used with some Sd dialog boxes. Here are some tips to keep in mind when using the CtrlSetText function with Sd dialog boxes:

• CtrlSetText should not be used with built-in dialog boxes. Changing the static text in a built-in dialog could cause the dialog box not to function correctly.
• The dialog box must already be defined with EzDefineDialog before calling CtrlSetText. With the exception of SdShowMsg, you must call CtrlSetText from the appropriate Sd dialog box script file since the dialog is not defined during the Sd dialog function call. For more information, please refer to InstallShield Knowledge Base article Q100161 "HOWTO: Modifying Sd Dialog Boxes".
• CtrlSetText does not work with static text fields that have an ID of -1. An ID of -1 for a static text field means that the text should not be changed.
• This function can be used to change the message being displayed in the SdShowMsg dialog box. Remember, however, that the existing dialog box will not be resized when the text changes, so the new text should be about the same size as the existing text in the dialog box.

Note: When the SdShowMsg function is called with the FALSE parameter to dismiss the dialog box, the text string that is passed to the function is ignored. If you're using the FALSE option, it is not necessary to make sure that the text passed to the function is the same size as the text previously displayed in the dialog box.

Here is an example of using the CtrlSetText function to change the text of an SdShowMsg dialog box:

Additional Information

Additional information on each InstallScript function, including sample code, can be found in their self-titled topics in the InstallShield Help Library. For example, information on the function CtrlSetText can be found in the topic CtrlSetText.