Help files

Display Select From List Dialog Action

Description:

This Action displays a dialog box with options that lets the user select from a list.

displayselectlist.png
displayselectlist2.png
displayselectlist3.png
Properties:

Dialog Title:

Enter the text, or a previously defined text Variable, to be used as the Dialog title.

Dialog Message:

Enter the text, or a previously defined text Variable, to be displayed as a Prompt Message for the user.

List to choose from:

Enter a list of choices - one per line, or a previously defined variable that contains a list. This will be displayed as a drop-down menu for the user to choose from.

Keep Select Dialog Always on Top:

Choose whether the Selection Dialog should always remain on top of all other windows.

Limit to List:

Deselect this box if you wish to allow the user to enter their own answer outside of the list being displayed. This means the Action will act more like the "Display Input Dialog" action.

Allow Empty Selection:

Allow the user to not select anything, creating an empty Selected Item output.

Allow Multiple Selection:

Allow the user to select more than one choice. This means that the Selected Item and Selected Index variables will hold a list of items.

Preselect Items Starting with a + Sign:

This option is available only when the previous one (Allow Multiple Selection) is checked. By selecting this option all items with a '+' sign prepended on their name will appear automatically preselected (and the '+' sign will be removed from the item's text).

Store Selected Item into:

Enter the name of the Variable that will store the item selected from the list as text (or a list of text values if 'Allow Multiple Selection' is checked).

Store Selected Index into:

Enter the name of the Variable that will store the index number of the item(s) selected from the list. This allows you to use the item number instead of the full text of the user's choice. The Variable that will store the index of the selected item as number (or a list of numeric values if 'Allow Multiple Selection' is checked). If the 'Limit to List' box is not checked and the user enters a new value, the index value will be '-1'.

Store Button Pressed into:

Enter a name to be the variable that will store the name of the button pressed by the user (OK or Cancel).