action (schéma XML toast)

Spécifie un bouton affiché dans un toast.

Hiérarchie d’éléments

<Toast>
<actions>
<Entrée>

Syntax

<action content = string
    arguments = string
    activationType? = "foreground" | "background" | "protocol"
    placement? = "contextMenu"
    imageUri? = string
    hint-inputid = string
    hint-buttonStyle = "Success" | "Critical"
    hint-toolTip = string
/>

Clé :

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
contenu Contenu affiché sur le bouton. string Oui None
arguments Chaîne définie par l’application d’arguments que l’application recevra ultérieurement si l’utilisateur clique sur ce bouton. string Oui None
type Chaîne d’argument qui peut être passée à l’application associée pour fournir des informations spécifiques sur l’action qu’elle doit exécuter en réponse à l’action de l’utilisateur. string Oui None
activationType Détermine le type d’activation qui sera utilisé lorsque l’utilisateur interagit avec une action spécifique.
  • « foreground » : valeur par défaut. Votre application de premier plan est lancée.
  • « background » : votre tâche en arrière-plan correspondante est déclenchée et vous pouvez exécuter du code en arrière-plan sans interrompre l’utilisateur.
  • « protocole » : lancez une autre application à l’aide de l’activation du protocole.
string Non « foreground »
sélection élective Lorsque la valeur est « contextMenu », l’action devient une action de menu contextuel ajoutée au menu contextuel de la notification toast plutôt qu’à un bouton toast traditionnel. string Non None
imageUri URI de la source de l’image pour une icône de bouton toast. Ces icônes sont des images de 16 x 16 pixels transparentes blanches à une mise à l’échelle de 100 % et ne doivent pas comporter de remplissage inclus dans l’image elle-même. Si vous choisissez de fournir des icônes sur une notification toast, vous devez fournir des icônes pour tous vos boutons dans la notification, car elle transforme le style de vos boutons en boutons d’icône. Utilisez l’un des gestionnaires de protocole suivants :
  • http:// ou https:// : image web.
  • ms-appx:/// : image incluse dans le package d’application.
  • ms-appdata:///local/ : image enregistrée dans le stockage local.
  • file:/// : image locale. (Pris en charge uniquement pour les applications de bureau. Ce protocole ne peut pas être utilisé par les applications UWP.)
string Non None
hint-inputId Définissez sur l’ID d’une entrée pour positionner le bouton en regard de l’entrée. string Non None
hint-buttonStyle Style de bouton. useButtonStyle doit avoir la valeur true dans l’élément toast .
  • « Réussite » - Le bouton est vert
  • « Critique » : le bouton est rouge.
Notez que ces valeurs sont sensibles à la casse.
string Non None
hint-toolTip Info-bulle d’un bouton, si le bouton a une chaîne de contenu vide. string Non None

Éléments enfants

None

Éléments parents

Élément parent Description
actions Élément conteneur pour déclarer jusqu’à cinq entrées et jusqu’à cinq actions de bouton pour la notification toast.

Voir aussi