This action (kindly donated by Peter Thörnqvist) is an enhanced version of the Prompt for Variables action that allows you to specify the control types to be used at runtime in the prompt form. The action also has more features and allows greater customisation.
For more information on variables, including creating your own project and user variables, see here.
The general settings lets you customise the dialog appearance.
Dialog Caption - the text to appear in the dialog header.
Prompt Text - the text to appear at the top of the dialog (optional).
Word Wrap at Runtime - set this to automatically wrap the prompt text according to the width of the dialog.
Time Out In Seconds - The dialog will automatically close if the user hasn't interacted with the dialog for the specified time
Expand Variables - check this to replace variables with their value in the dialog
Dialog Width - set the width of the dialog at runtime. You may want to adjust this to a larger width to accommodate large pathnames or other options that require a lot of horizontal space. Be aware that the size of the dialog isn't too big for your user's monitors.
Default Button - This used for the timeout to choose a suitable action when the timeout is reached
Variables - this list allows you to select which variables should be added to the dialog at runtime. Selecting a variable that is checked allows you to configuring the settings for that variable.
Type - choose the type of the variable (this determines the control used at runtime).
|•||Text - a single line text field|
|•||Memo - a 6 line text field|
|•||Integer - a text field that only allows numbers to be entered|
|•||Float - a text field that only allows floating point values to be entered|
|•||Boolean - a checkbox|
|•||Date - a date chooser control|
|•||Time - a time chooser control|
|•||Sorted List - a combobox control (drop down list) that contains the sorted items entered in Values (one item per line)|
|•||Unsorted List - a combobox control (drop down list) that contains the items entered in Values (one item per line)|
|•||Select File - a text field that also allows browsing to a file|
|•||Select Folder - a text field that also allows browsing to a folder|
|•||Check List - a list of checkboxes with the values as entered in Values. The variable will be set to the text of the checkbox chosen.|
|•||Text (Password) - a single line text field that displays it's value as * so that others can't read the password entered|
Caption - the name of the control as it will appear on the dialog at runtime
Default - the default value of the control
Values can have initial defaults (which can be variable values or fixed values.)
For "Check List" type prompts, specify default values as a comma-delimited list of values to enable at runtime.
This tab allows you to set the order of the various controls as they will appear on the runtime dialog
This is the prompt form at Runtime, showing 4 variables. Note that clicking on the Cancel button would cause the action to fail and stop the run. Also notice that a timeout has been set and is currently at 23 seconds.