Difference between revisions of "Extensions.HMI.ConfirmDialog"

From emotive
Jump to navigation Jump to search
Line 1: Line 1:
 
{{DISPLAYTITLE:  '''ConfirmDialog'''}}[[Category:HMI]]
 
{{DISPLAYTITLE:  '''ConfirmDialog'''}}[[Category:HMI]]
 
== Classification ==
 
== Classification ==
{{ClassificationActivity | ConfirmDialog | Requests dialog, the user's confirmation | [[Action]]| [[Extensions.HMI|OTX HMI extension]] | [[Dialog related actions]] | - | - }}
+
{{ClassificationActivity | ConfirmDialog | Requests dialog, the user's confirmation | [[Action]]| [[Extensions.HMI|OTX HMI extension]] | [[Extensions.HMI#Actions|Dialog related actions]] | - | - }}
  
 
== OTL Syntax ==
 
== OTL Syntax ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
Hmi.ConfirmDialog(StringTerm, StringTerm, MessageType, ConfimationTypeVariable);
+
Hmi.ConfirmDialog(StringTerm, StringTerm, MessageTypeTerm, ConfimationTypeVariable);
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== Description ==
 
== Description ==
The '''ConfirmDialog''' activity shows a dialog, the user's confirmation requests. The selection of buttons and decorations can be configured by a parameter. '''ConfirmDialog''' is generally used to apply user acceptance before performing a procedure.
+
The '''ConfirmDialog''' activity shows a dialog, the user's confirmation requests. The selection of buttons and decorations can be configured by a parameter. Once one of the confirmation options is selected, the result field will contain the selected index of the options.
 +
 
 +
'''Confirmation''' dialogs are typically used to ask the user for acceptance before performing a procedure. Depending on the type of procedure to execute, it is possible to select different levels of severity.
  
 
== Properties ==
 
== Properties ==
 
{| {{TableHeader}}
 
{| {{TableHeader}}
 
{{TableRowPropertiesHeader}}
 
{{TableRowPropertiesHeader}}
{{TableRowPropertie1| MessageType | [[Extensions.HMI.MessageType|MessageType]] | [[Value]] | @MessageType:INFO | [0..1] | <nowiki>Message type = {INFO|WARNING|ERROR|YESNO_QUESTION|YESNOCANCEL_QUESTION}</nowiki>.}}
+
{{TableRowPropertie1| MessageType | [[Extensions.HMI.MessageType|MessageType]] | [[Term]] | @MessageType:INFO | [0..1] | This optional element defines the type of message and the buttons that shall be shown to the user to confirm the action <nowiki>Message type = {INFO|WARNING|ERROR|YESNO_QUESTION|YESNOCANCEL_QUESTION}</nowiki>.}}
{{TableRowPropertie2| Result | [[Core.DataTypes.SimpleDataType.Integer|Integer]] | [[Variable]] | - | [0..1] | The variable where the user's selection is stored.}}
+
{{TableRowPropertie2| Result | [[Extensions.HMI.ConfirmationType|ConfirmationType]] | [[Variable]] | - | [0..1] | The variable where the user's selection will be stored.}}
 
|}
 
|}
  
 
== OTL Examples ==
 
== OTL Examples ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
Hmi.ConfirmationType ConfirmationType1 = @ConfirmationTypes:YES;
+
HMI.ConfirmationType ConfirmationType1 = @ConfirmationType:YES;
 +
 
 +
/// Flow
  
Hmi.ConfirmDialog("Message", "Title", @MessageTypes:INFO, ConfirmationType1);
+
HMI.ConfirmDialog("Message", "Title", @MessageType:INFO, ConfirmationType1);
 
</syntaxhighlight>
 
</syntaxhighlight>
  

Revision as of 03:59, 28 September 2018

Classification

Name ConfirmDialog
Short Description Requests dialog, the user's confirmation
Class Action
Extension OTX HMI extension
Group Dialog related actions
Exceptions -
Checker Rules -
Standard Compliant Yes

OTL Syntax

Hmi.ConfirmDialog(StringTerm, StringTerm, MessageTypeTerm, ConfimationTypeVariable);

Description

The ConfirmDialog activity shows a dialog, the user's confirmation requests. The selection of buttons and decorations can be configured by a parameter. Once one of the confirmation options is selected, the result field will contain the selected index of the options.

Confirmation dialogs are typically used to ask the user for acceptance before performing a procedure. Depending on the type of procedure to execute, it is possible to select different levels of severity.

Properties

Name Data Type Class Default Cardinality Description
MessageType MessageType Term @MessageType:INFO [0..1] This optional element defines the type of message and the buttons that shall be shown to the user to confirm the action Message type = {INFO|WARNING|ERROR|YESNO_QUESTION|YESNOCANCEL_QUESTION}.
Result ConfirmationType Variable - [0..1] The variable where the user's selection will be stored.

OTL Examples

HMI.ConfirmationType ConfirmationType1 = @ConfirmationType:YES;

/// Flow

HMI.ConfirmDialog("Message", "Title", @MessageType:INFO, ConfirmationType1);

See also

InputDialog
ChoiceDialog
ShowDocumentDialog