single_char_delimiter( 'single' '|' 'multiple' )
[ '*' ]? choice_value'='
This command is useful when writing interactive macro-commands. It displays a dialog box containing specified
message and requesting the user to confirm an action (generally the command which follows this
confirm command in the macro). If the user clicks on the button, the action is to be performed. If the user clicks on the button, the action is to be canceled.
choices may be specified to let the user select one or more options before clicking the button.
Options are separated using a single character. This delimiter must be chosen in order to be absent from
message. It's typically
choice comprises an option value and some short text describing the option. The value of an option which is turned on is immediately preceded by
'*'. Examples: "
*yes=Yes, I want this!" and "
no=No, please don't.".
single' specifies that the user may select just one option. Keyword '
multiple' specifies that the user may select zero or more options.
choices have been specified and the user clicks the button, this commands returns the values of all selected options separated by a space character.
confirm Convert selected text to computeroutput? confirm |single|*doc=Entire document|sel=Selection only| Print