Prompt Using List Box Dialog

Description

The Prompt Using List Box action prompts the user with a list of options and stores the result in a text variable.

Procedure 

  1. Optionally, enter the title of the dialog box in the Dialog Title field.

  2. Enter choices, one per line, into the Choices field.

  3. Optionally, click the 'AZ up' or 'ZA down' buttons to sort the choices.

    images/Sort_Ascending_button.gif
    images/Sort_Descending_button.gif
  4. Optionally, enter one or more default values, one per line, into the Default Value field.

  5. Either:

    • 1. Enter the name of the variable that will receive the user selection in the Result variable name field.

    • 2. Click Select Existing Variable to use an existing variable. This will show global variables and any variables that might be available in an associated form.

  6. Optionally, change the scope of the result variable. There are two possible values:

    • "Shared". Available to other scripts associated with the current form.

    • "Global". Available to all scripts.

  7. Optionally, click the More options... button to display the More Options dialog.

    • 1. Optionally, select Return values in selection order. Otherwise, the values will be returned in the order established by the Choices list.

    • 2. Optionally, change the Selection style. The options are:

      • 1 = Single select

      • 2 = Multi-select, where a mouse click selects or un-selects a choice

      • 3 = Multi-select, with standard Windows behavior

    • 3. Click OK to continue.

  8. Click Next >.

  9. Optionally modify the comment that describes the action.

  10. Click Finish.

See Also