Ask user for one or more choices

Displays a dialog box that lets you ask end users to select between one or more options (check boxes). For instance, if they wish to install a component on their system or not (see components). You can also use the result of the question for a conditional if/then/else action.

Property NameData TypeDescription
CaptionStringThe title that appears on the dialog box or in the wizard’s instruction panel.
Choice1TitleStringThe text that appears on the first check box.
Choice1VariableVarNameThis is the variable that will store the result of choice number 1. For example %INSTALLIT%.
Choice1VisibleBooleanIndicates whether the first check box is visible or not
Choice2TitleStringThe text that appears on the second check box.
Choice2VariableVarNameThis is the variable that will store the result of choice number 2. For example %INSTALLIT%.
Choice2VisibleBooleanIndicates whether the second check box is visible or not
Choice3TitleStringThe text that appears on the third check box.
Choice3VariableVarNameThis is the variable that will store the result of choice number 3. For example %INSTALLIT%.
Choice3VisibleBooleanIndicates whether the third check box is visible or not
LabelTextStringThis text will be displayed near check boxes.
PromptTextStringThis is the text that appears in the title of the question window and asks end users.

The package will show a dialog box displaying the value of “PromptText” (the question) and all check boxes with Visible property set to True.

The initial state of the checkbox is set according to the value of ChoiceNVariable variables. For instance, if the variable mentioned in Choice1Variable is set to “1”, the first check box will be checked. Otherwise, it is unchecked. In the same way, the variable specified by “ChoiceNVariable” is set to the user’s answer when the OK (or Next) button is pressed. If the checkbox is checked, the variable’s value is set to 1. Otherwise it is set to 0.

If end users select the Cancel button, the package closes.

Properties for the screenshot above:

You can use a goto label statement to check whether an end user have entered correct information: click here for an example.

All available actions

© G.D.G. Software 2018. All rights reserved.