Show-MultipleChoiceDialog

This command shows a dialog box with different options. This can be used to provide the user with a list of mutually exclusive options to choose from. Each option is represented by a radio button.


Settings:

  • Text for dialog box
    Text displayed in the message window describing the options. You can format the text with line breaks and define multilingual messages. To specify multilingual text, use either the syntax known from DSM <dDeutscher Text auch mit Zeilenumbruch><eEnglisch text even with line breaks> or the syntax used by the Packaging PowerBench in the configuration files, where you prefix the language in curly brackets to the following text, for example {de} Deutscher Text auch mit Zeilenumbruch {en} English text even with line breaks.

    If the region and language settings of a computer are set to one of the supported languages, the corresponding text is displayed when the command is executed. In all other cases, the English text is displayed.
  • List of options
    The list of available options. The specification is made in the syntax <variable value>=text. Here you can also specify multilingual text, of which the appropriate one will be displayed (see "Text for dialog box" setting). 
  • Variable name
    Name of a variable containing the selected option. Specify only the name of the variable, not the $ sign and the curly braces. If the dialog is closed with "Cancel", the value of the variable will not be changed.


Example:

The following example defines a dialog with text and options in English and German. The selected option is stored in the _RebootAnswer variable.

The following screenshot shows the dialog box output by the above example at runtime on an English system:


Corresponds to DSM eScript command:

  • MultipleChoiceDlg


See also: