Prompt Using Check Box List Box

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' icon or 'ZA down' icon 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, select Has Select All link. This creates a button that allows the user to select all options.

    • 3. Optionally, select Has Un-select All link. This creates a button that allows the user to un-select all options.

    • 4. Optionally, select Has Wildcard select link. This creates a button that displays the Wildcard Select dialog.

    • 5. Optionally, enter a heading that will appear above the choices into the Heading text property.

    • 6. Optionally, change the Width property of the dialog in the dialog.

    • 7. Optionally, change the Height property of the dialog in the dialog.

    • 8. Click OK to continue.

  8. Click Next >.

  9. Optionally modify the comment that describes the action.

  10. Click Finish.

See Also