InstallSite Documentation for InstallShield 6

This page describes undocumented functionality of InstallShield Professional 6.

SdSetDlgTitle

Syntax

SdSetDlgTitle (szDialogName, hwndDialog, szTitle);

Description

This function sets the caption for old style dialogs or sets the text in the top banner area of Windows 2000 style dialogs. The dialog box already must have been defined with EzDefineDialog (or DefineDialog) and initialized by calling WaitOnDialog.

Parameters

szDialogName

Specifies the name of the dialog box that has been defined with EzDefineDialog (or DefineDialog).

hwndDialog

The window handle of the dialog box.

szTitle

Text that should be displayed on the white banner for Windows 2000 style dialogs or the caption bar for old style dialogs. Windows 2000 style dialogs can display two lines of text on the white banner, so this string can contain a line break "\n". The first line will be drawn with bold font.

Return values

unknown

Comments

• The window handle can be retrieved by calling CmdGetHwndDlg (szDialogName);
• SdSetDlgTitle is called in the DLG_INIT routine for a custom dialog box.