Partager via

Schéma de contenu toast

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

Si vous préférez utiliser du code XML brut au lieu de la bibliothèque 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.

Property Type Required 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.
Visual 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 composante 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.
Scenario 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.
Header 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.

Value Meaning
Default Le comportement normal du toast.
Reminder Notification de rappel. Cela s’affiche prédéfini et reste sur l’écran de l’utilisateur jusqu’à ce qu’il soit ignoré.
Alarm Notification d’alarme. Cela s’affiche prédéfini et reste sur l’écran de l’utilisateur jusqu’à ce qu’il soit ignoré. Par défaut, l'audio sera en boucle et utilisera l'audio d'alarme.
IncomingCall Notification d’appel entrante. Cela s’affiche prédéfini dans un format d’appel spécial et reste sur l’écran de l’utilisateur jusqu’à ce qu’il soit ignoré. L’audio boucle par défaut et utilise l’audio de sonnerie.

ToastVisual

La partie visuelle des toasts contient les associations, qui intègrent du texte, des images, du contenu adaptatif, et plus encore.

Property Type Required 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 nulle.
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 »
Language string false La locale cible de la charge utile visuelle lors de l’utilisation de ressources localisées, spécifiée en tant que balises de langue BCP-47 telles que «en-US» ou «fr-FR». Ce paramètre régional est remplacé par tout paramètre régional spécifié dans l'association ou le texte. Si aucune valeur n’est fournie, les paramètres régionaux du système seront 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.

Property Type Required 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 situés à la racine 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 Une image "héroïque" facultative qui est 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 »
Language string false La locale cible de la charge utile visuelle lors de l’utilisation de ressources localisées, spécifiée en tant que balises de langue BCP-47 telles que «en-US» ou «fr-FR». Ce paramètre régional est remplacé par tout paramètre régional spécifié dans l'association ou le texte. Si aucune valeur n’est fournie, les paramètres régionaux du système seront utilisés à la place.

IToastBindingGenericChild

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

Implementations
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

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

Property Type Required Description
Text 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, la pondération et l’opacité de la police du texte. 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’habillage 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 Alignement horizontal du texte. Fonctionne uniquement pour les éléments de texte à l’intérieur d’un groupe/sous-groupe.
Language string false Paramètres régionaux cibles de la charge utile XML, spécifiés en tant que balises de langage BCP-47 telles que «en-US» ou «fr-FR». Les paramètres régionaux spécifiés ici remplacent tous les autres paramètres définis, y compris ceux liés à la liaison ou à l'aspect visuel. Si cette valeur est une chaîne littérale, cet attribut est défini par défaut sur la langue de l’interface utilisateur 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.

Property Type Required 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, la pondération et l’opacité de la police. L’opacité subtile est de 60% opaque.

Value Meaning
Default Valeur par défaut. Le style est déterminé par le renderer.
Caption Plus petite que la taille de police du paragraphe.
CaptionSubtle Identique au texte, mais avec une opacité subtile.
Body Taille de police de paragraphe.
BodySubtle Identique à Body, mais avec une opacité subtile.
Base Taille de police de paragraphe, épaisseur en gras. Essentiellement la version en gras de Body.
BaseSubtle Identique à Base, mais avec une opacité subtile.
Subtitle Taille de police H4.
SubtitleSubtle Identique au sous-titre, mais avec une opacité subtile.
Title Taille de police H3.
TitleSubtle Identique au titre, mais avec une opacité subtile.
TitleNumeral Identique au titre, mais avec espacement supérieur/inférieur supprimé.
Subheader Taille de police H2.
SubheaderSubtle Identique à Subheader mais avec une opacité subtile.
SubheaderNumeral Identique à Subheader, mais avec les marges supérieure et inférieure supprimées.
Header Taille de police H1.
HeaderSubtle Identique à l’en-tête, mais avec une opacité subtile.
HeaderNumeral Identique à l’en-tête, mais avec les marges en haut et en bas supprimées.

AdaptiveTextAlign

Contrôle l’alignement horizontal du texte.

Value Meaning
Default Valeur par défaut. L’alignement est automatiquement déterminé par le renderer.
Auto 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

Image intégrée.

Property Type Required Description
Source string true URL de l’image. ms-appx, ms-appdata et http sont pris en charge. À compter de Fall Creators Update, les images web peuvent être jusqu’à 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 Ko.
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 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.

Value Meaning
Default Valeur par défaut. Comportement de rognage déterminé par le moteur de rendu.
None L’image n’est pas rognée.
Circle L’image est rognée en forme de cercle.

AdaptiveImageAlign

Spécifie l’alignement horizontal d’une image.

Value Meaning
Default Valeur par défaut. Comportement d’alignement déterminé par le renderer.
Stretch 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, affichant 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.

Property Type Required 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.

Property Type Required 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.

Implementations
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking spécifie l’alignement vertical du contenu.

Value Meaning
Default Valeur par défaut. Renderer sélectionne automatiquement l’alignement vertical par défaut.
Top Aligner verticalement en haut.
Center Aligner verticalement sur le centre.
Bottom 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.

Property Type Required Description
Title chaîne ou BindableString false Obtient ou définit une chaîne de titre facultative. Prend en charge la liaison de données.
Value double ou AdaptiveProgressBarValue ou BindableProgressBarValue false Obtient ou définit la valeur de la barre de progression. Prend en charge 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.
Status 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.

Property Type Required Description
Value 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. Si ceci est vrai, la valeur sera ignorée.

BindableProgressBarValue

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

Property Type Required 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.

Property Type Required Description
Source string true URL de l’image. ms-appx, ms-appdata et http sont pris en charge. Les images HTTP doivent être de 200 Ko ou moins.
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.

Value Meaning
Default Le rognage utilise le comportement par défaut du moteur de rendu.
None L’image n’est pas rognée, elle est affichée au format carré.
Circle L’image est rognée en cercle.

ToastGenericHeroImage

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

Property Type Required Description
Source string true URL de l’image. ms-appx, ms-appdata et http sont pris en charge. Les images HTTP doivent être de 200 Ko ou moins.
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.

Property Type Required Description
Text string true Texte à afficher.
Language string false La locale cible de la charge utile visuelle lors de l’utilisation de ressources localisées, spécifiée en tant que balises de langue BCP-47 telles que «en-US» ou «fr-FR». Si aucune valeur n’est fournie, les paramètres régionaux du système seront utilisés à la place.

IToastActions

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

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

Property Type Required Description
Inputs 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.
Buttons 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 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 de notification.

Implementations
ToastTextBox
ToastSelectionBox

ToastTextBox

Implémente IToastInput

Contrôle de zone de texte dans lequel l’utilisateur peut taper du texte.

Property Type Required 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.
Title 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.

Property Type Required Description
Id string true L’ID est requis. Si l'utilisateur a sélectionné cet élément, cet ID sera retourné au code de votre application, représentant la sélection.
Content string true Le contenu est obligatoire et est une chaîne qui s’affiche sur l’élément sélectionné.

ToastSelectionBoxItem

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

Property Type Required 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.
Title string false Texte de titre à afficher au-dessus de la zone de sélection.
DefaultSelectionBoxItemId string false Cela contrôle quel élément est sélectionné par défaut et fait référence à la propriété Id du ToastSelectionBoxItem. Si vous ne fournissez pas cela, la sélection par défaut est vide (l’utilisateur ne voit rien).
Items IList<ToastSelectionBoxItem> false Les éléments parmi lesquels l’utilisateur peut choisir dans cette boîte de sélection. Seuls 5 éléments peuvent être ajoutés.

IToastButton

Interface de marquage pour les boutons de notification.

Implementations
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Implémente IToastButton

Bouton sur lequel l’utilisateur peut cliquer.

Property Type Required Description
Content string true Required. Texte à afficher sur le bouton.
Arguments string true Required. 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.

Value Meaning
Foreground 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.
Protocol Lancez une autre application à l’aide de l’activation du protocole.

ToastActivationOptions

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

Property Type Required 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.

Value Meaning
Default Comportement par défaut. Le toast sera ignoré lorsque l'utilisateur effectuera une action dessus.
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 devriez mettre à jour votre toast sans délai à partir d'une tâche en arrière-plan afin que l'utilisateur ne voie pas cet « état visuel de mise à jour en attente » trop longtemps.

ToastButtonSnooze

Implémente IToastButton

Bouton de mise en veille géré par le système qui gère automatiquement la mise en veille des notifications.

Property Type Required 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 de fermeture géré par le système qui ferme la notification lorsqu'on clique dessus.

Property Type Required 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 de rappel et les boutons snooze/rejet, tout est automatiquement localisé et la logique de rappel est gérée automatiquement par le système.

Property Type Required Description
ContextMenuItems IList<ToastContextMenuItem> false Nouveauté de la mise à jour 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.

Property Type Required Description
Content string true Required. Texte à afficher.
Arguments string true Required. 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.

Property Type Required 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 boolean 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).
Silent boolean false "True" pour désactiver le son ; "false" pour autoriser le son de notification toast à être joué (valeur par défaut).

ToastHeader

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

Property Type Required 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.
Title 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 être 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 seuls Foreground et Protocol sont pris en charge.
ActivationOptions ToastActivationOptions false Obtient ou définit des options supplémentaires relatives à l’activation de l’en-tête toast.
  • Last updated on