Difference between revisions of "Extensions.HMI.ChoiceDialog"
Jump to navigation
Jump to search
| (2 intermediate revisions by one other user not shown) | |||
| Line 5: | Line 5: | ||
== OTL Syntax == | == OTL Syntax == | ||
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | <syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | ||
| − | HMI.ChoiceDialog(StringTerm, StringTerm, ListTerm, IntegerTerm, IntegerVariable); | + | HMI.ChoiceDialog(StringTerm message, StringTerm title, ListTerm options, IntegerTerm default, IntegerVariable result); |
</syntaxhighlight> | </syntaxhighlight> | ||
== Description == | == Description == | ||
| − | The '''ChoiceDialog''' | + | The '''ChoiceDialog''' will present a list of options to the user. It will be possible for the user to select one of the options and to dismiss the dialog (e.g. by double-clicking an option or by clicking an "OK" button, etc.). Once the dialog is dismissed, the chosen option's index will be assigned to a result variable. It will not be possible to dismiss the dialog unless a choice has been made. |
== Properties == | == Properties == | ||
{| {{TableHeader}} | {| {{TableHeader}} | ||
{{TableRowPropertiesHeader}} | {{TableRowPropertiesHeader}} | ||
| − | {{TableRowPropertie2| Options | [[Core.DataTypes.ComplexDataType.List|List]] | [[Term]] | - | [1] | This element specifies a list of strings which contains the possible options that | + | {{TableRowPropertie2| Options | [[Core.DataTypes.ComplexDataType.List|List]] | [[Term]] | - | [1] | This element specifies a list of strings which contains the possible options that will be displayed.}} |
| − | {{TableRowPropertie1| Default | [[Core.DataTypes.SimpleDataType.Integer|Integer]] | [[Term]] | - | [0..1] | This optional element represents the index of the option which | + | {{TableRowPropertie1| Default | [[Core.DataTypes.SimpleDataType.Integer|Integer]] | [[Term]] | - | [0..1] | This optional element represents the index of the option which will be preselected in the dialog.}} |
| − | {{TableRowPropertie2| Result | [[Core.DataTypes.SimpleDataType.Integer|Integer]] | [[Variable]] | - | [1] | This element indicates the integer variable where the chosen option's index | + | {{TableRowPropertie2| Result | [[Core.DataTypes.SimpleDataType.Integer|Integer]] | [[Variable]] | - | [1] | This element indicates the integer variable where the chosen option's index will be assigned to: |
* 0 :The 1st option was selected. | * 0 :The 1st option was selected. | ||
* n-1: The nth option was selected.}} | * n-1: The nth option was selected.}} | ||
| Line 23: | Line 23: | ||
== OTL Examples == | == OTL Examples == | ||
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | <syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | ||
| + | /// Local Declarations | ||
| + | |||
List<String> Options1 = {"Option1", "Option2"}; | List<String> Options1 = {"Option1", "Option2"}; | ||
Integer Integer1; | Integer Integer1; | ||
Latest revision as of 02:33, 13 September 2019
Classification
| Name | ChoiceDialog |
| Short Description | Dialog that indicates to the user with a list of choices |
| Class | Action |
| Extension | OTX HMI extension |
| Group | Dialog related actions |
| Exceptions | OutOfBoundsException |
| Checker Rules | HMI_Chk001 |
| Standard Compliant | Yes |
OTL Syntax
HMI.ChoiceDialog(StringTerm message, StringTerm title, ListTerm options, IntegerTerm default, IntegerVariable result);Description
The ChoiceDialog will present a list of options to the user. It will be possible for the user to select one of the options and to dismiss the dialog (e.g. by double-clicking an option or by clicking an "OK" button, etc.). Once the dialog is dismissed, the chosen option's index will be assigned to a result variable. It will not be possible to dismiss the dialog unless a choice has been made.
Properties
| Name | Data Type | Class | Default | Cardinality | Description |
| Options | List | Term | - | [1] | This element specifies a list of strings which contains the possible options that will be displayed. |
| Default | Integer | Term | - | [0..1] | This optional element represents the index of the option which will be preselected in the dialog. |
| Result | Integer | Variable | - | [1] | This element indicates the integer variable where the chosen option's index will be assigned to:
|
OTL Examples
/// Local Declarations
List<String> Options1 = {"Option1", "Option2"};
Integer Integer1;
/// Flow
HMI.ChoiceDialog("Message", "Title", Options1, 1, Integer1);