Zeigt einen Dialogbildschirm an, der die Interaktion des Benutzers erfordert. Es sendet die Dialogereignisse, die aufgetreten sind, sobald das Fenster geschlossen wird.
Bezeichner: ui_page_dialog
Attribute
Typ: Definiert die Visualisierung der Meldung.
Mögliche Werte: INFO, ZWISCHENFORTSCHRITT, FORTSCHRITT, FRAGE, BENACHRICHTIGUNG, WARNUNG, FEHLER, FATAL
- Erforderlich: ja
- Standardwert: leer
Titel: Ein kurzer Name für den Dialog.
Mögliche Werte: Kann ein Verweis auf eine Android-Ressource oder ein String sein
- Erforderlich: nein
- Standardwert: leer
Elemente
Meldungen: Enthält eine Liste von Meldungen, die im Dialogfeld angezeigt werden sollen. Kann entweder auf eine Kontextvariable oder auf eine Liste von Meldungen verweisen. Wenn eine Kontextvariable referenziert wird, wird das Attribut context_variable auf den booleschen Wert true gesetzt.
- Erforderlich: ja
- Standardwert: leer
Schaltflächen: Dies enthält eine Liste von drei Schaltflächen, auf die der Benutzer klicken kann.
Buttons
Es gibt drei Schaltflächen, auf die der Benutzer klicken kann:
- vorherige_seite_btn
- nächste_seite_btn
- schließen_btn
Text: Was auf der Schaltfläche steht.
- Erforderlich: ja
- Standardwert: leer
sprach_befehl: Der Sprachbefehl, der diese Schaltfläche auslöst.
- Erforderlich: nein
- Standardwert: leer
fokussiert: Legt eine Taste zur Vorauswahl fest.
- Erforderlich: nein
- Standardwert: false
Befehl: Der Ereignisbefehl, der ausgelöst wird, sobald die Schaltfläche gedrückt wird. Dies ist nur für close_btn verfügbar .
Ausgabe
Löst Ereignisse aus, die den angegebenen Befehl innerhalb einer Schaltfläche enthalten, sobald die Schaltfläche angeklickt (oder ihr Sprachbefehl erkannt) wird.
Beispiele
Minimal
<ui_page_dialog id="show-server-errors-dialog" type="ERROR" title="Procedure failed">
<messages>
<message>First Error...</message>
<message>Second Error...</message>
<message>Third Error...</message>
</messages>
<buttons>
<previous_page_btn>
<param name="text">←</param>
<param name="speech_command">PREVIOUS</param>
</previous_page_btn>
<next_page_btn>
<param name="text">→</param>
<param name="speech_command">NEXT</param>
<param name="focused">true</param>
</next_page_btn>
<close_btn>
<param name="text">ANDRRES_cancel</param>
<param name="command">EXIT_PAGER</param>
<param name="speech_command">CANCEL</param>
</close_btn>
</buttons>
</ui_page_dialog>
Alle Optionen
<ui_page_dialog id="confirm_pick" type="INFO" title="Here we go again">
<messages>
<message>what</message>
<message>to</message>
<message>do</message>
</messages>
<buttons>
<previous_page_btn>
<text><![CDATA[<]]></text>
<speech_command>PREVIOUS</speech_command>
<focused>false</focused>
</previous_page_btn>
<next_page_btn>
<text><![CDATA[>]]></text>
<speech_command>NEXT</speech_command>
<focused>true</focused>
</next_page_btn>
<close_btn>
<text>Return</text>
<command>BW</command>
<speech_command>RETURN</speech_command>
<focused>false</focused>
</close_btn>
</buttons>
</ui_page_dialog>
Verwendung von context_variable = true
<ui_page_dialog id="confirm_what_to_do" type="INFO" title="Here we go again">
<messages context_variable="true">#{what_to_do}</messages>
<buttons>
<previous_page_btn>
<text><![CDATA[<]]></text>
<speech_command>PREVIOUS</speech_command>
<focused>false</focused>
</previous_page_btn>
<next_page_btn>
<text><![CDATA[>]]></text>
<speech_command>NEXT</speech_command>
<focused>false</focused>
</next_page_btn>
<close_btn>
<text>ANDRRES_cancel</text>
<command>BW</command>
<speech_command>RETURN</speech_command>
<focused>false</focused>
</close_btn>
</buttons>
</ui_page_dialog>
Umgang mit dem Ergebnis
<rule id="confirm_what_to_do_back">
<expression> <![CDATA[#{event:command} == 'BW' || #{event:command} == 'RETURN']]> </expression>
<actions>
<action ref="backwards"></action>
</actions>
</rule>
