action (Toast XML Schema)

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"
    afterActivationBehavior? = "default" | "pendingUpdate"
    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’arguments définie par l’application 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 détails 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.
  • « arrière-plan » : 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 No « au premier plan »
afterActivationBehavior Spécifie le comportement que le toast doit utiliser lorsque l’utilisateur effectue une action sur le toast.
  • « default » : valeur par défaut. Le toast est ignoré lorsque l’utilisateur effectue une action sur le toast.
  • « pendingUpdate » : une fois que l’utilisateur a cliqué sur un bouton de votre toast, la notification reste présente, dans un état visuel « mise à jour en attente ». Vous devez immédiatement mettre à jour votre toast à partir d’une tâche en arrière-plan afin que l’utilisateur ne voit pas cet état visuel « mise à jour en attente » pendant trop longtemps.
string No « valeur par défaut »
sélection élective Lorsqu’elle est définie sur « 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 d’image pour une icône de bouton toast. Ces icônes sont des images blanches transparentes de 16 x 16 pixels à une mise à l’échelle de 100 % et ne doivent pas avoir 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 cela 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 à positionner en regard de l’entrée. string Non None
hint-buttonStyle Style de bouton. useButtonStyle doit être défini sur 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 Aucun

Éléments enfants

None

Éléments parents

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

Voir aussi