Schéma de contenu de vignette

  • Article

L’exemple suivant décrit toutes les propriétés et tous les éléments dans le contenu des vignettes.

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

TileContent

TileContent

TileContent est l’objet de niveau supérieur qui décrit le contenu d’une notification de vignette, y compris les visuels.

Propriété Type Requise Description
Visuel ToastVisual true Décrit la partie visuelle de la notification de vignette.

TileVisual

La partie visuelle des vignettes contient les spécifications visuelles pour toutes les tailles de vignettes et d’autres propriétés liées au visuel.

Propriété Type Requise Description
TileSmall TileBinding false Fournissez une petite liaison facultative pour spécifier le contenu de la petite taille de vignette.
TileMedium TileBinding false Fournissez une liaison moyenne facultative pour spécifier le contenu de la taille de vignette moyenne.
TileWide TileBinding false Fournissez une liaison large facultative pour spécifier le contenu de la taille de la vignette large.
TileLarge TileBinding false Fournissez une liaison volumineuse facultative pour spécifier le contenu de la grande taille de vignette.
Personnalisation TileBranding false Formulaire que la vignette doit utiliser pour afficher la marque de l’application. Par défaut, hérite de la personnalisation de la vignette par défaut.
Nom d’affichage string false Chaîne facultative pour remplacer le nom complet de la vignette lors de l’affichage de cette notification.
Arguments string false Nouveau dans la mise à jour de la date anniversaire : données définies par l'application qui sont renvoyées à votre application via la propriété TileActivatedInfo sur LaunchActivatedEventArgs lorsque l'utilisateur lance votre application à partir de la vignette dynamique. Cela vous permet de savoir quelles notifications de vignette votre utilisateur a vu lorsqu’il a tapé votre vignette dynamique. Sur les appareils sans la mise à jour de la date anniversaire, cela sera simplement ignoré.
LockDetailedStatus1 string false Si vous spécifiez cela, vous devez également fournir une liaison TileWide. Il s’agit de la première ligne de texte qui s’affiche sur l’écran de verrouillage si l’utilisateur a sélectionné votre vignette comme application d’état détaillée.
LockDetailedStatus2 string false Si vous spécifiez cela, vous devez également fournir une liaison TileWide. Il s’agit de la deuxième ligne de texte qui s’affiche sur l’écran de verrouillage si l’utilisateur a sélectionné votre vignette comme application d’état détaillée.
LockDetailedStatus3 string false Si vous spécifiez cela, vous devez également fournir une liaison TileWide. Il s’agit de la troisième ligne de texte qui s’affiche sur l’écran de verrouillage si l’utilisateur a sélectionné votre vignette comme application d’état détaillée.
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 »
Langage 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.

TileBinding

L’objet de liaison contient le contenu visuel d’une taille de vignette spécifique.

Propriété Type Requise Description
Contenu ITileBindingContent false Contenu visuel à afficher sur la vignette. L’une des TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContentPeople, ou TileBindingContentPhotos.
Personnalisation TileBranding false Formulaire que la vignette doit utiliser pour afficher la marque de l’application. Par défaut, hérite de la personnalisation de la vignette par défaut.
Nom d’affichage string false Chaîne facultative pour remplacer le nom complet de la vignette pour cette taille de vignette.
Arguments string false Nouveau dans la mise à jour de la date anniversaire : données définies par l'application qui sont renvoyées à votre application via la propriété TileActivatedInfo sur LaunchActivatedEventArgs lorsque l'utilisateur lance votre application à partir de la vignette dynamique. Cela vous permet de savoir quelles notifications de vignette votre utilisateur a vu lorsqu’il a tapé votre vignette dynamique. Sur les appareils sans la mise à jour de la date anniversaire, cela sera simplement ignoré.
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 »
Langage 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.

ITileBindingContent

Interface de marqueur pour le contenu de liaison de vignette. Celles-ci vous permettent de choisir ce que vous souhaitez spécifier vos visuels de vignette dans : adaptatifs ou l’un des modèles spéciaux.

Implémentations
TileBindingContentAdaptive
TileBindingContentIconic
TileBindingContentContact
TileBindingContentPeople
TileBindingContentPhotos

TileBindingContentAdaptive

Pris en charge pour toutes les tailles. Il s’agit de la méthode recommandée pour spécifier le contenu de votre vignette. Les modèles de vignette adaptative sont nouveaux dans Windows 10 et vous pouvez créer une grande variété de vignettes personnalisées par le biais d’une fonctionnalité adaptative.

Propriété Type Requise Description
Children IList<ITileBindingContentAdaptiveChild> false Éléments visuels inclus. Les objets AdaptiveText, AdaptiveImage et AdaptiveGroup peuvent être ajoutés. Les enfants sont affichés à la mode StackPanel vertical.
BackgroundImage TileBackgroundImage false Image d’arrière-plan facultative qui s’affiche derrière tout le contenu de la vignette, entièrement sautée.
PeekImage TilePeekImage false Image d’aperçu facultative qui s’anime en haut de la vignette.
TextStacking TileTextStacking false Contrôle l’empilement de texte (alignement vertical) du contenu enfant dans son ensemble.

AdaptiveText

Un élément de texte adaptatif.

Propriété Type Requise Description
Texte string false Texte à afficher.
HintStyle AdaptiveTextStyle false Le style contrôle la taille de police du texte, sa pondération et son opacité.
HintWrap bool? false Définissez cette valeur sur true pour activer l’ajustement du texte. La valeur par défaut est « false ».
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.
HintAlign AdaptiveTextAlign false L'alignement horizontal du texte.
Langage 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.

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 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.
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 de vignette. 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

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

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.

TileBackgroundImage

Image d’arrière-plan affichée en mode complet sur la vignette.

Propriété Type Requise Description
Source string true L’URL de l’image. ms-appx, ms-appdata et http(s) sont pris en charge. Les images HTTP doivent être de 200 Kb ou moins de taille.
HintOverlay int? false Superposition noire sur l’image d’arrière-plan. Cette valeur contrôle l’opacité de la superposition noire, avec 0 sans superposition et 100 étant complètement noir. La valeur par défaut est 20.
HintCrop TileBackgroundImageCrop false Nouveauté de la version 1511 : spécifiez la façon dont vous souhaitez que l’image soit rognée. Dans les versions antérieures à la version 1511, cette image sera ignorée et l’image d’arrière-plan s’affichera sans rognage.
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 de vignette. 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 »

TileBackgroundImageCrop

Contrôle le rognage de l’image d'arrière-plan.

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.

TilePeekImage

Image d’aperçu qui s’anime en haut de la vignette.

Propriété Type Requise Description
Source string true L’URL de l’image. ms-appx, ms-appdata et http(s) sont pris en charge. Les images HTTP doivent être de 200 Kb ou moins de taille.
HintOverlay int? false Nouveauté en 1511 : superposition noire sur l’image d’aperçu. Cette valeur contrôle l’opacité de la superposition noire, avec 0 sans superposition et 100 étant complètement noir. La valeur par défaut est 20. Dans les versions précédentes, cette valeur est ignorée et l’image d’aperçu s’affiche avec 0 superposition.
HintCrop TilePeekImageCrop false Nouveauté de la version 1511 : spécifiez la façon dont vous souhaitez que l’image soit rognée. Dans les versions antérieures à la version 1511, cette image est ignorée et l’image d’aperçu s’affiche sans rognage.
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 de vignette. 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 »

TilePeekImageCrop

Contrôle le rognage de l’image d’aperçu.

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.

TileTextStacking

L'empilement du texte 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.

TileBindingContentIconic

Prise en charge sur petite et moyenne. Active un modèle de vignette emblématique, où vous pouvez avoir une icône et un badge à côté de l’autre sur la vignette, dans le style de Windows Phone classique. Le nombre en regard de l’icône est obtenu via une notification de badge distincte.

Propriété Type Requise Description
Icône TileBasicImage true Au minimum, pour prendre en charge les vignettes Desktop et Mobile, Small et Medium, fournissent une image de rapport d’aspect carré avec une résolution de 200 x 200, format PNG, avec transparence et aucune couleur autre que le blanc. Pour plus d’informations, consultez : Modèles de vignette spéciaux.

TileBindingContentContact

Mobile uniquement. Prise en charge sur petit, moyen et large.

Propriété Type Requise Description
Image TileBasicImage true Image à afficher.
Texte TileBasicText false Ligne de texte affichée. Non affiché sur la petite vignette.

TileBindingContentPeople

Nouveautés de la version 1511 : prise en charge sur moyen, large et grand (Bureau et mobile). Auparavant, il s’agissait de Mobile uniquement et uniquement moyen et large.

Propriété Type Requise Description
Images IList<TileBasicImage> true Images qui se déplacent sous forme de cercles.

TileBindingContentPhotos

Anime à travers un diaporama de photos. Pris en charge pour toutes les tailles.

Propriété Type Requise Description
Images IList<TileBasicImage> true Jusqu’à 12 images peuvent être fournies (Mobile affiche uniquement jusqu’à 9), qui seront utilisées pour le diaporama. L’ajout de plus de 12 lève une exception.

TileBasicImage

Image utilisée sur différents modèles spéciaux.

Propriété Type Requise Description
Source string true L’URL de l’image. ms-appx, ms-appdata et http(s) 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 de vignette. 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 »

TileBasicText

Élément de texte de base utilisé sur différents modèles spéciaux.

Propriété Type Requise Description
Texte string false Texte à afficher.
Langage 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.