Dialog Customization Functions

InstallShield 2014 ยป InstallScript Language Reference

Use the following functions to create and customize new InstallScript dialogs, and to modify the text, controls, and behavior of InstallScript dialogs. Some of the functions handle custom dialog processing.

Any Windows dialog that you can create can be used in a setup script. The dialogs can have single and multiline edit boxes, single and multiselection list boxes, combo boxes, radio buttons, check boxes, and push buttons as standard controls. For more complex controls, advanced functions such as CmdGetHwndDlg, LOWORD, and HIWORD are provided.

Dialog Customization Functions

Function

Description

CmdGetHwndDlg

Retrieves the handle of a dialog.

CtrlClear

Deletes the contents of an edit, static, list box, or combo box control.

CtrlDir

Fills a list box or combo box with either a directory listing or a file listing.

CtrlGetCurSel

Returns the selected item from a list box or combo box.

CtrlGetDlgItem

Retrieves the window handle of a control in a custom dialog.

CtrlGetMLEText

Retrieves the text from a multi-line edit or static field.

CtrlGetMultCurSel

Returns the selected items from a multi-selection list box.

CtrlGetState

Retrieves the state of a radio button, check box, or push button control from a dialog.

CtrlGetSubCommand

Retrieves the operation performed on the control after a WaitOnDialog function call.

CtrlGetText

Retrieves the text from an edit field, a static field, or the edit field of a combo box.

CtrlGetUrlForLinkClicked

Retrieves the URL for a link that an end user clicked.

CtrlPGroups

Retrieves a list of program group names that exist on the target system.

CtrlSelectText

Selects the text displayed in an edit field.

CtrlSetCurSel

Finds and sets the current selection in a list box or combo box.

CtrlSetFont

Specifies a font for a control in the dialog.

CtrlSetList

Places the contents of a list into a list box or combo box.

CtrlSetMLEText

Sets the text in a multi-line edit field.

CtrlSetMultCurSel

Sets the current selection in a multi-selection list box.

CtrlSetState

Sets the current state of a check box, radio button, or push button control.

CtrlSetText

Sets the text in an edit field, a static text field, or the edit field of a combo box.

DefineDialog

Registers a custom dialog with InstallShield.

DialogSetFont

Sets the font for dialogs displayed during the setup.

DialogSetInfo

Changes display elements in the dialogs presented by some built-in dialog functions.

EndCurrentDialog

Closes the currently displayed dialog by calling EndDialog.

EndDialog

Closes a custom dialog.

EzDefineDialog

Registers a custom dialog with InstallShield.

GetCurrentDialogName

Retrieves the name of the currently displayed dialog as it was specified in the call to EzDefineDialog when the dialog was defined.

GetFont

Retrieves the handle of a font.

HIWORD

Retrieves the high-order word from a 32-bit integer.

LOWORD

Retrieves the low-order word from a 32-bit integer.

ReleaseDialog

Frees the memory associated with a dialog.

SdGeneralInit

Provides standard dialog initialization, including setting the enable or disable state of the Next, Back, and Cancel buttons. This function also replaces all %P, %VS, and %VI instances on static controls with control IDs 700 through 724, and 202.

SdInit

Prepares a setup for calls to Sd dialog functions.

SdLoadString

Returns the string value associated with a specified resource ID.

SdMakeName

Creates a section name for a custom dialog. This section name is used in writing to and reading from an .iss file, which is used by InstallShield Silent.

SdProductName

Inserts your product name in certain static fields of the script dialogs.

SdSubstituteProductInfo

Replaces any occurrences of the %P, %VS, and %VI placeholders with the values of the system variables IFX_PRODUCT_DISPLAY_NAME, IFX_PRODUCT_DISPLAY_VERSION, and IFX_INSTALLED_DISPLAY_VERSION. You can use this function before calling a function, such as MessageBox, that does not automatically perform this replacement before displaying strings.

SilentReadData

Instructs InstallShield Silent to read the .iss file dialog data for a custom dialog.

SilentWriteData

Instructs InstallShield Silent to write to the .iss file dialog data for a custom dialog.

WaitOnDialog

Presents a custom dialog.

See Also