CtrlSetMultCurSel

InstallShield 2016 » InstallScript Language Reference

The CtrlSetMultCurSel function searches the specified multi-selection list or combo box control. If nSelectFlag is set to TRUE, CtrlSetMultCurSel selects (highlights) the item when it is found. This function is for use only with custom dialogs.

Syntax

CtrlSetMultCurSel (szDialogName, nControlID, szText, nSelectFlag);

Parameters

CtrlSetMultCurSel Parameters

Parameter

Description

szDialogName

Specifies the name of a custom dialog.

nControlID

Specifies the resource ID of the multi-selection list box control in the dialog.

szText

Specifies the search string.

nSelectFlag

Indicates whether or not to select an item when CtrlSetMultCurSel finds it. Pass one of the following predefined constants in this parameter:

TRUE—Indicates that the item is to be selected.
FALSE—Indicates that the item is not to be selected.

Return Values

CtrlSetMultCurSel Return Values

Return Value

Description

0

CtrlSetMultCurSel successfully found the text in the control and either selected it or did not select it, as indicated in nSelectFlag.

< 0

CtrlSetMultCurSel was unable to find the text in the control.

See Also