Affiche un écran de dialogue qui nécessite l'interaction de l'utilisateur. Il envoie les événements de dialogue qui se sont produits une fois la fenêtre fermée.
Identifiant : ui_page_dialog
Attributs
type : Définit la visualisation de la notification.
Valeurs possibles : INFO, INTERMEDIATEPROGRESS, PROGRESS, PROGRESS, QUESTION, NOTIFICATION, WARN, ERROR, FATAL
- Obligatoire : oui
- Valeur par défaut : empty
Titre : Un nom court pour le dialogue.
Valeurs possibles : Peut être une référence à une ressource androïde ou une chaîne de caractères.
- Obligatoire : non
- Valeur par défaut : empty
Éléments
messages : Contient une liste de messages qui seront affichés dans la boîte de dialogue. Peut faire référence à une variable contextuelle ou à une liste de messages. En cas de référence à une variable contextuelle, l'attribut context_variable prend la valeur booléenne true.
- Obligatoire : oui
- Valeur par défaut : empty
boutons : Ce champ contient une liste de trois boutons sur lesquels l'utilisateur peut cliquer.
Boutons
L'utilisateur peut cliquer sur trois boutons :
- previous_page_btn
- page_suivante_btn
- fermer_btn
le texte : Ce qui est écrit sur le bouton.
- Obligatoire : oui
- Valeur par défaut : empty
speech_command : La commande vocale qui déclenche ce bouton.
- Obligatoire : non
- Valeur par défaut : empty
ciblée : Définit un bouton à présélectionner.
- Obligatoire : non
- Valeur par défaut : false
commande : La commande d'événement qui est déclenchée lorsque le bouton est enfoncé. Ceci n'est disponible que pour close_btn.
Sortie
Déclenche des événements qui contiennent la commande spécifiée dans un bouton, une fois que le bouton est cliqué (ou que sa commande vocale est reconnue).
Exemples
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>
Toutes les options
<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>
Utilisation de 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>
Traitement du résultat
<rule id="confirm_what_to_do_back">
<expression> <![CDATA[#{event:command} == 'BW' || #{event:command} == 'RETURN']]> </expression>
<actions>
<action ref="backwards"></action>
</actions>
</rule>
