toast (schéma XML toast)

Élément toast de base, qui contient au moins un élément visuel unique.

Hiérarchie d’éléments

<Toast>

Syntaxe

<toast launch?   = string
      duration? = "long" | "short" 
      displayTimeStamp? = string
      scenario? = "reminder" | "alarm" | "incomingCall" | "urgent" 
      useButtonStyle? = boolean>

  <!-- Child elements -->
  visual,
  audio?,
  commands?
  actions?
  header?
</toast>

Clé

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
duration

Durée d’affichage du toast.

Cet attribut peut avoir l’une des valeurs suivantes :

  • long
  • short
Non None
Lancement

Chaîne transmise à l’application lorsqu’elle est activée par la notification toast. L’application définit le format et le contenu de cette chaîne pour son propre usage. Lorsque l’utilisateur appuie ou clique sur la notification toast pour lancer l’application qui lui est associée, la chaîne de lancement précise le contexte à l’application pour permettre à cette dernière de présenter à l’utilisateur une vue adaptée au contenu de la notification toast plutôt qu’une vue par défaut.

chaîne Non None
displayTimestamp

Introduit dans Creators Update : remplace l’horodatage par défaut par un horodatage personnalisé représentant le moment où votre contenu de notification a été effectivement remis, plutôt que l’heure à laquelle la notification a été reçue par la plateforme Windows. Cette valeur doit être une chaîne mise en forme à l’aide de la norme ISO 8601.

chaîne Non None
scénario

Le scénario pour lequel votre toast est utilisé, comme une alarme ou un rappel.

  • « rappel » : notification de rappel. Cette opération s’affiche prédéfini et reste à l’écran de l’utilisateur jusqu’à ce qu’elle soit ignorée.
  • « alarme » : notification d’alarme. Cette opération s’affiche prédéfini et reste à l’écran de l’utilisateur jusqu’à ce qu’elle soit ignorée. L’audio effectue une boucle par défaut et utilise l’audio d’alarme.
  • « incomingCall » : notification d’appel entrante. Cette option s’affiche pré-développée dans un format d’appel spécial et reste à l’écran de l’utilisateur jusqu’à ce qu’elle soit ignorée. L’audio effectue une boucle par défaut et utilise l’audio sonnerie.
  • « urgent » : une notification importante. Cela permet aux utilisateurs d’avoir plus de contrôle sur les applications qui peuvent leur envoyer des notifications toast à priorité élevée qui peuvent passer par Focus Assist (Ne pas déranger). Cela peut être modifié dans les paramètres de notifications.

chaîne Non None
useButtonStyle

Spécifie si les boutons avec style doivent être utilisés. Le style du bouton est déterminé par l’attribut **hint-buttonStyle** de l’élément [action](element-action.md).

boolean Non false

 

Éléments enfants

Élément enfant Description
audio

Spécifie un son à lire lorsqu’une notification toast est affichée. Cet élément vous permet également de désactiver le son de notification toast.

commands

Spécifie que la notification toast est utilisée pour indiquer un appel entrant ou une alarme, avec les commandes appropriées associées à chaque scénario.

Visual

Contient un élément de liaison unique qui définit un toast.

actions

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

en-tête

Introduit dans Creators Update. Spécifie un en-tête personnalisé qui regroupe plusieurs notifications dans le Centre de notifications.

 

Éléments parents

Cet élément externe (document) ne peut pas être contenu par d’autres éléments.

Voir aussi