toast (toast XML Schema)

  • Article

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

Hiérarchie d’éléments

<Toast>

Syntax

<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 pendant laquelle le toast doit s’afficher.

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.

 string 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.

 string Non None
scénario

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

  • « rappel » : notification de rappel. Celui-ci s’affiche pré-développé et reste sur l’écran de l’utilisateur jusqu’à ce qu’il soit ignoré. Notez que cela sera ignoré silencieusement, sauf s’il existe une action de bouton toast qui s’active en arrière-plan.
  • « alarm » : notification d’alarme. Celui-ci s’affiche pré-développé et reste sur l’écran de l’utilisateur jusqu’à ce qu’il soit ignoré. L’audio est en boucle par défaut et utilise l’audio d’alarme.
  • « incomingCall » : notification d’appel entrant. Celui-ci s’affiche au préalable dans un format d’appel spécial et reste sur l’écran de l’utilisateur jusqu’à ce qu’il soit ignoré. L’audio est en boucle par défaut et utilise l’audio de sonnerie.
  • « urgent » : notification importante. Cela permet aux utilisateurs d’avoir plus de contrôle sur les applications qui peuvent leur envoyer des notifications toast de priorité élevée qui peuvent passer par l’assistant de focus (Ne pas déranger). Cela peut être modifié dans les paramètres de notifications.

 string 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 d’action .

 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 toute notification toast audio.
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 permettant de 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 le plus externe (document) ne peut pas être contenu par d’autres éléments.

Voir aussi