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.