Changing the Text on Dialogs in InstallScript and InstallScript MSI Projects

InstallShield 2020

Project:This information applies to the following project types:

InstallScript
InstallScript MSI

Most dialog functions accept a string argument called szTitle that defines the text appearing in the title area of the dialog. For example, the call to SdRegisterUser appears as follows:

SdRegisterUser( szTitle, szMsg, szName, szCompany );

By default, the parameter szTitle is defined as a null string (""), which indicates that the dialog should use the default title text. For SdRegisterUser, the default title appears as shown in the following screen shot.

Default Title Text for the SdRegisterUser Dialog

To modify the title, you can enter specific strings to display for the szTitle parameter. The title is divided into two sections—the bold text at the top of the title area, and the regular text under the main title.

To specify the two sections in the value of szTitle, place a newline character \n between the two sections.

SdRegisterUser ("New Title\nThis is a new subtitle.",

    szMsg, szName, szCompany);

After recompiling the script and running the installation, the title is displayed as shown in the following sample screen shot.

Changed Title Text for the SdRegisterUser Dialog

To change other text displayed on a dialog, there are usually one or more parameters (such as szMsg) that contain the text to be displayed. As with dialog box titles, a null string in a message parameter indicates that the dialog should use the default message text provided by InstallShield.

If your installation contains more than one UI language, you can use string identifiers instead of hard-coded strings in your InstallScript. For more information, see Using String Entries in InstallShield.