Schéma du contenu de notification toast

  • Article

Les éléments suivants décrivent toutes les propriétés et éléments au sein du contenu toast.

Si vous préférez utiliser du code XML brut au lieu de la bibliothèque de notifications, consultez le schéma XML.

ToastContent

ToastContent

ToastContent est l’objet de niveau supérieur qui décrit le contenu d’une notification, y compris les visuels, les actions et l’audio.

Propriété Type Requise Description
Launch string false Chaîne transmise à l’application lorsqu’elle est activée par le Toast. Le format et le contenu de cette chaîne sont définis par l’application pour sa propre utilisation. Lorsque l’utilisateur appuie ou clique sur toast pour lancer son application associée, la chaîne de lancement fournit le contexte à l’application qui lui permet d’afficher à l’utilisateur une vue pertinente pour le contenu toast, plutôt que de lancer de sa façon par défaut.
Visuel ToastVisual true Décrit la partie visuelle de la notification toast.
Actions IToastActions false Vous pouvez éventuellement créer des actions personnalisées avec des boutons et des entrées.
Audio ToastAudio false Décrit la partie audio de la notification toast.
ActivationType ToastActivationType false Spécifie le type d’activation qui sera utilisé lorsque l’utilisateur clique sur le corps de ce toast.
ActivationOptions ToastActivationOptions false Nouveauté de Creators Update : options supplémentaires relatives à l’activation de la notification toast.
Scénario ToastScenario false Déclare le scénario pour lequel votre toast est utilisé, comme une alarme ou un rappel.
DisplayTimestamp DateTimeOffset ? false Nouveauté de Creators Update : remplacez l’horodatage par défaut par un horodatage personnalisé représentant le moment où votre contenu de notification a été réellement remis, plutôt que le moment où la notification a été reçue par la plateforme Windows.
En-tête ToastHeader false Nouveauté de Creators Update : ajoutez un en-tête personnalisé à votre notification pour regrouper plusieurs notifications dans le Centre de notifications.

ToastScenario

Spécifie le scénario que représente le toast.

Valeur Signification
Par défaut Comportement toast normal.
Rappel Notification et rappels Cela s’affiche prédéfini et reste sur l’écran de l’utilisateur jusqu’à ce qu’il soit ignoré.
Alarme Notification d’alarme. Cela s’affiche prédéfini et reste sur l’écran de l’utilisateur jusqu’à ce qu’il soit ignoré. L’audio effectue une boucle par défaut et utilise l’audio d’alarme.
IncomingCall les notifications d’appels entrants. Les notifications d’appels entrants s’affichent en mode aperçu dans un format d’appel spécial et restent sur l’écran de l’utilisateur jusqu’à ce qu’il les ignore. L’audio boucle par défaut et utilise l’audio de sonnerie.

ToastVisual

La partie visuelle des toasts contient les liaisons, qui contiennent du texte, des images, du contenu adaptatif, etc.

Propriété Type Requise Description
BindingGeneric ToastBindingGeneric true Liaison toast générique, qui peut être rendue sur tous les appareils. Cette liaison est requise et ne peut pas être null.
BaseUri Uri false URL de base par défaut combinée à des URL relatives dans les attributs source d’image.
AddImageQuery bool? false Définissez la valeur « true » pour permettre à Windows d’ajouter une chaîne de requête à l’URL de l’image fournie dans la notification toast. Utilisez cet attribut si votre serveur héberge des images et peut gérer les chaînes de requête, soit en récupérant une variante d’image basée sur les chaînes de requête, soit en ignorant la chaîne de requête et en retournant l’image comme spécifié sans la chaîne de requête. Cette chaîne de requête spécifie la mise à l’échelle, le paramètre de contraste et la langue ; par exemple, une valeur de « www.website.com/images/hello.png » donnée dans la notification devient « www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us »
Langue string false Paramètres régionaux cibles de la charge utile visuelle lors de l’utilisation de ressources localisées, spécifiées en tant que balises de langue BCP-47 telles que « en-US » ou « fr-FR ». Ces paramètres régionaux sont substitués par les paramètres régionaux spécifiés dans la liaison ou le texte. S’il n’est pas fourni, les paramètres régionaux système sont utilisés à la place.

ToastBindingGeneric

La liaison générique est la liaison par défaut pour les toasts, et est l’endroit où vous spécifiez le texte, les images, le contenu adaptatif, etc.

Propriété Type Requise Description
Children IList<IToastBindingGenericChild> false Contenu du corps du Toast, qui peut inclure du texte, des images et des groupes (ajoutés dans la mise à jour anniversaire). Les éléments de texte doivent être fournis avant les autres éléments, et seuls 3 éléments de texte sont pris en charge. Si un élément de texte est placé après tout autre élément, il est extrait vers le haut ou supprimé. Enfin, certaines propriétés de texte telles que HintStyle ne sont pas prises en charge sur les éléments de texte enfants racines et fonctionnent uniquement à l’intérieur d’un AdaptiveSubgroup. Si vous utilisez AdaptiveGroup sur des appareils sans la mise à jour anniversaire, le contenu du groupe est simplement supprimé.
AppLogoOverride ToastGenericAppLogo false Logo facultatif pour remplacer le logo de l’application.
HeroImage ToastGenericHeroImage false Image facultative « héros » affichée sur le toast et dans le Centre de notifications.
Attribution ToastGenericAttributionText false Texte d’attribution facultatif qui s’affiche au bas de la notification toast.
BaseUri Uri false URL de base par défaut combinée à des URL relatives dans les attributs source d’image.
AddImageQuery bool? false Définissez la valeur « true » pour permettre à Windows d’ajouter une chaîne de requête à l’URL de l’image fournie dans la notification toast. Utilisez cet attribut si votre serveur héberge des images et peut gérer les chaînes de requête, soit en récupérant une variante d’image basée sur les chaînes de requête, soit en ignorant la chaîne de requête et en retournant l’image comme spécifié sans la chaîne de requête. Cette chaîne de requête spécifie la mise à l’échelle, le paramètre de contraste et la langue ; par exemple, une valeur de « www.website.com/images/hello.png » donnée dans la notification devient « www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us »
Langue string false Paramètres régionaux cibles de la charge utile visuelle lors de l’utilisation de ressources localisées, spécifiées en tant que balises de langue BCP-47 telles que « en-US » ou « fr-FR ». Ces paramètres régionaux sont substitués par les paramètres régionaux spécifiés dans la liaison ou le texte. S’il n’est pas fourni, les paramètres régionaux système sont utilisés à la place.

IToastBindingGenericChild

Interface de marqueur pour les éléments enfants toast qui incluent du texte, des images, des groupes, etc.

Implémentations
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

Un élément de texte adaptatif. S’il est placé dans le niveau supérieur ToastBindingGeneric.Children, seuls HintMaxLines sont appliqués. Toutefois, s’il est placé en tant qu’enfant d’un groupe/sous-groupe, le style de texte intégral est pris en charge.

Propriété Type Requise Description
Texte chaîne ou BindableString false Texte à afficher. Prise en charge de la liaison de données ajoutée dans Creators Update, mais fonctionne uniquement pour les éléments de texte de niveau supérieur.
HintStyle AdaptiveTextStyle false Le style contrôle la taille de police du texte, sa pondération et son opacité. Fonctionne uniquement pour les éléments de texte à l’intérieur d’un groupe/sous-groupe.
HintWrap bool? false Définissez cette valeur sur true pour activer l’ajustement du texte. Les éléments de texte de niveau supérieur ignorent cette propriété et encapsulent toujours (vous pouvez utiliser HintMaxLines = 1 pour désactiver l’habillage pour les éléments de texte de niveau supérieur). Les éléments de texte à l’intérieur de groupes/sous-groupes ont la valeur false par défaut pour l’habillage.
HintMaxLines int? false Le nombre maximal de lignes que l’élément de texte est autorisé à afficher.
HintMinLines int? false Nombre minimal de lignes que l’élément de texte doit afficher. Fonctionne uniquement pour les éléments de texte à l’intérieur d’un groupe/sous-groupe.
HintAlign AdaptiveTextAlign false L'alignement horizontal du texte. Fonctionne uniquement pour les éléments de texte à l’intérieur d’un groupe/sous-groupe.
Langue string false Paramètres régionaux cibles de la charge utile XML, spécifiés en tant que balises de langue BCP-47 telles que « en-US » ou « fr-FR ». Les paramètres régionaux spécifiés ici remplacent tous les autres paramètres régionaux spécifiés, tels que ceux de la liaison ou du visuel. Si cette valeur est une chaîne littérale, cet attribut est défini par défaut sur la langue de l’IU de l’utilisateur. Si cette valeur est une référence de chaîne, cet attribut est défini par défaut sur les paramètres régionaux choisis par Windows Runtime pour résoudre la chaîne.

BindableString

Valeur de liaison pour les chaînes.

Propriété Type Requise Description
BindingName string true Obtient ou définit le nom qui correspond à votre valeur de données de liaison.

AdaptiveTextStyle

Le style de texte contrôle la taille de police, la pondération et l’opacité. L’opacité légère est opaque de 60 %.

Valeur Signification
Par défaut Valeur par défaut. Le style est déterminé par le renderer.
Caption Plus petit que la taille de police du paragraphe.
CaptionSubtle Identique à la légende, mais avec une opacité légère.
Corps Taille de police de paragraphe.
BodySubtle Identique au corps, mais avec une opacité légère.
Base Taille de police de paragraphe, épaisseur en gras. Essentiellement la version en gras de Corps.
BaseSubtle Identique à la base, mais avec une opacité légère.
Subtitle Taille de police H4.
SubtitleSubtle Identique au sous-titre, mais avec une opacité légère.
Titre Taille de police H3.
TitleSubtle Identique au titre, mais avec une opacité légère.
TitleNumeral Identique au titre, mais avec remplissage supérieur/inférieur supprimé.
Subheader Taille de police H2.
SubheaderSubtle Identique au sous-titre mais avec une opacité légère.
SubheaderNumeral Identique au sous-titre, mais avec remplissage supérieur/inférieur supprimé.
En-tête Taille de police H1.
HeaderSubtle Identique à l’en-tête, mais avec une opacité légère.
HeaderNumeral Identique à l’en-tête, mais avec remplissage supérieur/inférieur supprimé.

AdaptiveTextAlign

Contrôle les alignements horizontaux du texte.

Valeur Signification
Par défaut Valeur par défaut. L’alignement est automatiquement déterminé par le renderer.
Automatique Alignement déterminé par la langue et la culture actuelles.
Left Alignez horizontalement le texte à gauche.
Center Alignez horizontalement le texte dans le centre.
Right Alignez horizontalement le texte à droite.

AdaptiveImage

Une image incorporée.

Propriété Type Requise Description
Source string true L’URL de l’image. ms-appx, ms-appdata et http sont pris en charge. Dans la mise à jour Fall Creators, les images web peuvent atteindre 3 Mo sur les connexions normales et 1 Mo sur les connexions limitées. Sur les appareils qui n’exécutent pas encore Fall Creators Update, les images web ne doivent pas dépasser 200 Kb.
HintCrop AdaptiveImageCrop false Nouveauté de la mise à jour anniversaire : contrôlez le rognage souhaité de l’image.
HintRemoveMargin bool? false Par défaut, les images à l’intérieur de groupes/sous-groupes ont une marge 8px autour d’elles. Vous pouvez supprimer cette marge en définissant cette propriété sur true.
HintAlign AdaptiveImageAlign false L'alignement horizontal de l’image. Fonctionne uniquement pour les images à l’intérieur d’un groupe/sous-groupe.
AlternateText string false Texte de remplacement décrivant l’image, utilisé à des fins d’accessibilité.
AddImageQuery bool? false Définissez la valeur « true » pour permettre à Windows d’ajouter une chaîne de requête à l’URL de l’image fournie dans la notification toast. Utilisez cet attribut si votre serveur héberge des images et peut gérer les chaînes de requête, soit en récupérant une variante d’image basée sur les chaînes de requête, soit en ignorant la chaîne de requête et en retournant l’image comme spécifié sans la chaîne de requête. Cette chaîne de requête spécifie la mise à l’échelle, le paramètre de contraste et la langue ; par exemple, une valeur de « www.website.com/images/hello.png » donnée dans la notification devient « www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us »

AdaptiveImageCrop

Spécifie le rognage souhaité de l’image.

Valeur Signification
Par défaut Valeur par défaut. Comportement de rognage déterminé par le renderer.
Aucun L’image n’est pas rognée.
Circle L’image est rognée sur une forme de cercle.

AdaptiveImageAlign

Spécifie l'alignement horizontal du texte pour une image.

Valeur Signification
Par défaut Valeur par défaut. Comportement d’alignement déterminé par le renderer.
Étirer L’image s’étend pour remplir la largeur disponible (et éventuellement la hauteur disponible, selon l’emplacement où l’image est placée).
Left Alignez l’image à gauche, affichant l’image à sa résolution native.
Center Alignez l’image au centre horizontalement, affichez l’image à sa résolution native.
Right Alignez l’image à droite, affichant l’image à sa résolution native.

AdaptiveGroup

Nouveauté de la mise à jour anniversaire : les groupes identifient sémantiquement que le contenu du groupe doit être affiché dans son ensemble, ou non s’il ne peut pas correspondre. Les groupes autorisent également la création de plusieurs colonnes.

Propriété Type Requise Description
Children IList<AdaptiveSubgroup> false Les sous-groupes sont affichés sous forme de colonnes verticales. Vous devez utiliser des sous-groupes pour fournir tout contenu à l’intérieur d’un AdaptiveGroup.

AdaptiveSubgroup

Nouveauté de la mise à jour anniversaire : les sous-groupes sont des colonnes verticales qui peuvent contenir du texte et des images.

Propriété Type Requise Description
Children IList<IAdaptiveSubgroupChild> false AdaptiveText et AdaptiveImage sont des enfants valides de sous-groupes.
HintWeight int? false Contrôlez la largeur de cette colonne de sous-groupe en spécifiant le poids, par rapport aux autres sous-groupes.
HintTextStacking AdaptiveSubgroupTextStacking false Contrôlez l’alignement vertical du contenu de ce sous-groupe.

IAdaptiveSubgroupChild

Interface de marqueur pour les enfants de sous-groupes.

Implémentations
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking spécifie l'alignement vertical du contenu.

Valeur Signification
Par défaut Valeur par défaut. Renderer sélectionne automatiquement l’alignement vertical par défaut.
Top Aligner verticalement sur le haut.
Center Aligner verticalement sur le centre.
Bas Aligner verticalement sur le bas.

AdaptiveProgressBar

Nouveautés de Creators Update : barre de progression. Uniquement pris en charge sur les toasts sur Desktop, build 15063 ou version ultérieure.

Propriété Type Requise Description
Titre chaîne ou BindableString false Obtient ou définit un délai d'attente facultatif. Prise en charge de la liaison de données.
Valeur Double ou AdaptiveProgressBarValue ou BindableProgressBarValue false Obtient ou définit l’état de la barre de progression. Prise en charge de la liaison de données. La valeur par défaut est 0.
ValueStringOverride chaîne ou BindableString false Obtient ou définit une chaîne facultative à afficher au lieu de la chaîne de pourcentage par défaut. Si ce n’est pas fourni, quelque chose comme « 70 % » s’affiche.
État chaîne ou BindableString true Obtient ou définit une chaîne d’état (obligatoire), qui s’affiche sous la barre de progression à gauche. Cette chaîne doit refléter l’état de l’opération, comme « Téléchargement... » ou « Installation... »

AdaptiveProgressBarValue

Classe qui représente la valeur de la barre de progression.

Propriété Type Requise Description
Valeur double false Obtient ou définit la valeur (0,0 à 1,0) représentant le pourcentage terminé.
IsIndeterminate bool false Obtient ou définit une valeur indiquant si la barre de progression est indéterminée. S’il s’agit de la valeur true, la valeur est ignorée.

BindableProgressBarValue

Valeur de barre de progression pouvant être liée.

Propriété Type Requise Description
BindingName string true Obtient ou définit le nom qui correspond à votre valeur de données de liaison.

Logo à afficher au lieu du logo de l’application.

Propriété Type Requise Description
Source string true L’URL de l’image. ms-appx, ms-appdata et http sont pris en charge. Les images HTTP doivent être de 200 Kb ou moins de taille.
HintCrop ToastGenericAppLogoCrop false Spécifiez la façon dont vous souhaitez que l’image soit rognée.
AlternateText string false Texte de remplacement décrivant l’image, utilisé à des fins d’accessibilité.
AddImageQuery bool? false Définissez la valeur « true » pour permettre à Windows d’ajouter une chaîne de requête à l’URL de l’image fournie dans la notification toast. Utilisez cet attribut si votre serveur héberge des images et peut gérer les chaînes de requête, soit en récupérant une variante d’image basée sur les chaînes de requête, soit en ignorant la chaîne de requête et en retournant l’image comme spécifié sans la chaîne de requête. Cette chaîne de requête spécifie la mise à l’échelle, le paramètre de contraste et la langue ; par exemple, une valeur de « www.website.com/images/hello.png » donnée dans la notification devient « www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us »

ToastGenericAppLogoCrop

Contrôle le rognage de l’image du logo de l’application.

Valeur Signification
Par défaut Le rognage utilise le comportement par défaut du renderer.
Aucun L’image n’est pas rognée, affichée carrée.
Circle L’image est rognée dans un cercle.

ToastGenericHeroImage

Image « héros » proposée qui s’affiche sur le toast et dans le Centre de notifications.

Propriété Type Requise Description
Source string true L’URL de l’image. ms-appx, ms-appdata et http sont pris en charge. Les images HTTP doivent être de 200 Kb ou moins de taille.
AlternateText string false Texte de remplacement décrivant l’image, utilisé à des fins d’accessibilité.
AddImageQuery bool? false Définissez la valeur « true » pour permettre à Windows d’ajouter une chaîne de requête à l’URL de l’image fournie dans la notification toast. Utilisez cet attribut si votre serveur héberge des images et peut gérer les chaînes de requête, soit en récupérant une variante d’image basée sur les chaînes de requête, soit en ignorant la chaîne de requête et en retournant l’image comme spécifié sans la chaîne de requête. Cette chaîne de requête spécifie la mise à l’échelle, le paramètre de contraste et la langue ; par exemple, une valeur de « www.website.com/images/hello.png » donnée dans la notification devient « www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us »

ToastGenericAttributionText

Texte d’attribution affiché en bas de la notification toast.

Propriété Type Requise Description
Texte string true Texte à afficher.
Langue string false Paramètres régionaux cibles de la charge utile visuelle lors de l’utilisation de ressources localisées, spécifiées en tant que balises de langue BCP-47 telles que « en-US » ou « fr-FR ». S’il n’est pas fourni, les paramètres régionaux système sont utilisés à la place.

IToastActions

Interface de marqueur pour les actions/entrées toast.

Implémentations
ToastActionsCustom
ToastActionsSnoozeAndDismiss

ToastActionsCustom

Implémente IToastActions

Créez vos propres actions et entrées personnalisées à l’aide de contrôles tels que des boutons, des zones de texte et des entrées de sélection.

Propriété Type Requise Description
Entrées IList<IToastInput> false Entrées telles que les zones de texte et les entrées de sélection. Seules 5 entrées sont autorisées.
Boutons IList<IToastButton> false Les boutons s’affichent après toutes les entrées (ou adjacentes à une entrée si le bouton est utilisé comme bouton de réponse rapide). Seuls 5 boutons sont autorisés (ou moins si vous avez également des éléments de menu contextuel).
ContextMenuItems IList<ToastContextMenuItem> false Nouveauté de la mise à jour à la date anniversaire : éléments de menu contextuel personnalisé, fournissant des actions supplémentaires si l’utilisateur clique avec le bouton droit sur la notification. Vous ne pouvez avoir que 5 boutons et éléments de menu contextuel combinés.

IToastInput

Interface de marqueur pour les entrées toast.

Implémentations
ToastTextBox
ToastSelectionBox

ToastTextBox

Implémente IToastInput

Le contrôle TextBox permet à un utilisateur de taper du texte dans une application.

Propriété Type Requise Description
Id string true L’ID est requis et est utilisé pour mapper le texte entré par l’utilisateur dans une paire clé-valeur d’ID/valeur que votre application consomme ultérieurement.
Titre string false Texte de titre à afficher au-dessus de la zone de texte.
PlaceholderContent string false Texte d’espace réservé à afficher dans la zone de texte lorsque l’utilisateur n’a pas encore tapé de texte.
DefaultInput string false Texte initial à placer dans la zone de texte. Laissez cette valeur Null pour une zone de texte vide.

ToastSelectionBox

Implémente IToastInput

Contrôle de zone de sélection, qui permet aux utilisateurs de choisir dans une liste déroulante d’options.

Propriété Type Requise Description
Id string true L’ID est requis. Si l’utilisateur a sélectionné cet élément, cet ID est repassé au code de votre application, représentant la sélection choisie.
Contenu string true Le contenu est obligatoire et est une chaîne qui s’affiche sur l’élément de sélection.

ToastSelectionBoxItem

Élément de zone de sélection (élément que l’utilisateur peut sélectionner dans la liste déroulante).

Propriété Type Requise Description
Id string true L’ID est requis et est utilisé pour mapper le texte entré par l’utilisateur dans une paire clé-valeur d’ID/valeur que votre application consomme ultérieurement.
Titre string false Texte de titre à afficher au-dessus de la zone de sélection.
DefaultSelectionBoxItemId string false Cet élément est sélectionné par défaut et fait référence à la propriété Id de l’objet ToastSelectionBoxItem. Si vous ne fournissez pas cela, la sélection par défaut est vide (l’utilisateur ne voit rien).
Articles IList<ToastSelectionBoxItem> false Éléments de sélection que l’utilisateur peut choisir dans ce SelectionBox. Seuls 5 éléments peuvent être ajoutés.

IToastButton

Interface de marqueur pour les boutons toast.

Implémentations
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Implémente IToastButton

Boutons sur lesquels l’utilisateur peut cliquer.

Propriété Type Requise Description
Contenu string true Obligatoire. Texte à afficher dans .
Arguments string true Obligatoire. Chaîne définie par l’application d’arguments que l’application recevra ultérieurement si l’utilisateur clique sur ce bouton.
ActivationType ToastActivationType false Contrôle le type d’activation que ce bouton utilisera lorsque vous cliquez dessus. Par défaut, au premier plan.
ActivationOptions ToastActivationOptions false Nouveauté de Creators Update : Obtient ou définit des options supplémentaires relatives à l’activation du bouton toast.

ToastActivationType

Détermine le type d’activation qui sera utilisé lorsque l’utilisateur interagit avec une action spécifique.

Valeur Signification
Premier plan Valeur par défaut. Votre application de premier plan est lancée.
Background Votre tâche en arrière-plan correspondante (en supposant que vous configurez tout) est déclenchée et vous pouvez exécuter du code en arrière-plan (comme l’envoi du message de réponse rapide de l’utilisateur) sans interrompre l’utilisateur.
Protocole Lancez une autre application à l’aide de l’activation du protocole.

ToastActivationOptions

Nouveautés de Creators Update : options supplémentaires relatives à l’activation.

Propriété Type Requise Description
AfterActivationBehavior ToastAfterActivationBehavior false Nouveauté de Fall Creators Update : obtient ou définit le comportement que le toast doit utiliser lorsque l’utilisateur appelle cette action. Cela fonctionne uniquement sur Desktop, pour ToastButton et ToastContextMenuItem.
ProtocolActivationTargetApplicationPfn string false Si vous utilisez ToastActivationType.Protocol, vous pouvez éventuellement spécifier le PFN cible, afin que, indépendamment de l’inscription de plusieurs applications pour gérer le même URI de protocole, votre application souhaitée sera toujours lancée.

ToastAfterActivationBehavior

Spécifie le comportement que le toast doit utiliser lorsque l’utilisateur effectue une action sur le toast.

Valeur Signification
Par défaut Comportement par défaut. Le toast est ignoré lorsque l’utilisateur effectue une action sur le toast.
PendingUpdate Une fois que l’utilisateur clique sur un bouton sur 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.

ToastButtonSnooze

Implémente IToastButton

Bouton snooze géré par le système qui gère automatiquement l’noozing de la notification.

Propriété Type Requise Description
CustomContent string false Texte personnalisé facultatif affiché sur le bouton qui remplace le texte « Snooze » localisé par défaut.

ToastButtonDismiss

Implémente IToastButton

Bouton d’abandon géré par le système qui ignore la notification en cliquant dessus.

Propriété Type Requise Description
CustomContent string false Texte personnalisé facultatif affiché sur le bouton qui remplace le texte « Ignorer » localisé par défaut.

ToastActionsSnoozeAndDismiss

*Implémente IToastActions

Construit automatiquement une zone de sélection pour les intervalles d’nooze et les boutons snooze/ignorer, toutes les logiques localisées automatiquement et la logique d’noozation est gérée automatiquement par le système.

Propriété Type Requise Description
ContextMenuItems IList<ToastContextMenuItem> false Nouveauté de la mise à jour à la date anniversaire : éléments de menu contextuel personnalisé, fournissant des actions supplémentaires si l’utilisateur clique avec le bouton droit sur la notification. Vous ne pouvez avoir que 5 éléments.

ToastContextMenuItem

Entrée d’élément de menu contextuel.

Propriété Type Requise Description
Contenu string true Obligatoire. Texte à afficher.
Arguments string true Obligatoire. Chaîne définie par l’application d’arguments que l’application peut récupérer ultérieurement une fois qu’elle est activée lorsque l’utilisateur clique sur l’élément de menu.
ActivationType ToastActivationType false Contrôle le type d’activation que cet élément de menu utilisera lorsque vous cliquez dessus. Par défaut, au premier plan.
ActivationOptions ToastActivationOptions false Nouveauté de Creators Update : options supplémentaires relatives à l’activation de l’élément de menu contextuel toast.

ToastAudio

Spécifiez l’audio à lire lorsque la notification Toast est reçue.

Propriété Type Requise Description
Src URI false Fichier multimédia à lire à la place du son par défaut. Seuls ms-appx et ms-resource sont pris en charge. Tout le reste (ms-appdata, http, C :, etc.) n’est pas pris en charge.
Loop booléen false Défini sur true si le son doit se répéter tant que le toast est affiché ; false à lire une seule fois (valeur par défaut).
Silencieux booléen false True pour désactiver le son ; false pour autoriser le son de notification toast à lire (valeur par défaut).

ToastHeader

Nouveauté de Creators Update : en-tête personnalisé qui regroupe plusieurs notifications dans le Centre de notifications.

Propriété Type Requise Description
Id string true Identificateur créé par le développeur qui identifie de façon unique cet en-tête. Si deux notifications ont le même ID d’en-tête, elles sont affichées sous le même en-tête dans le Centre de notifications.
Titre string true Titre de l’en-tête.
Arguments string true Obtient ou définit une chaîne d’arguments définie par le développeur qui est retournée à l’application lorsque l’utilisateur clique sur cet en-tête. Ne peut pas avoir la valeur null.
ActivationType ToastActivationType false Obtient ou définit le type d’activation que cet en-tête utilisera en cliquant dessus. Par défaut, au premier plan. Notez que seul le premier plan et le protocole sont pris en charge.
ActivationOptions ToastActivationOptions false Obtient ou définit des options supplémentaires relatives à l’activation de l’en-tête toast.