liaison (schéma de vignette)

Article
02/01/2024

Spécifie le modèle de vignette. Chaque notification doit inclure un élément de liaison pour chaque taille de vignette prise en charge.

Hiérarchie d’éléments

<tile>

<visuel>: <binding>

Syntax

<binding template       = tileTemplateNameV2
         fallback?      = tileTemplateNameV1
         lang?          = string
         baseUri?       = anyURI
         branding?      = "none" | "logo" | "name"
         addImageQuery? = boolean
         contentId?     = string >

  <!-- Child elements -->
  ( image
  | text
  )*

</binding>

Clé :

? facultatif (zéro ou un) * facultatif (zéro ou plus)

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire	Valeur par défaut
addImageQuery	Définissez sur true pour permettre à Windows d’ajouter une chaîne de requête à l’URI d’image fourni dans la notification par vignette. Utilisez cet attribut si votre serveur héberge des images et peut gérer des 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 l’échelle, le paramètre de contraste et la langue ; pour instance, la valeur de « www.website.com/images/hello.png » inclus dans la notification devient « www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us »	boolean	Non	false
baseUri	URI de base par défaut qui est combiné avec des URI relatifs dans les attributs de source d’image.	anyURI	No	ms-appx:///
Marque	Formulaire que la vignette doit utiliser pour afficher la marque de l’application.	Cet attribut peut avoir l’une des valeurs suivantes : aucun Logo name	Non	Logo
contentId	Définissez sur une chaîne définie par l’expéditeur qui identifie de manière unique le contenu de la notification. Cela empêche les doublons dans le cas où un modèle de vignette volumineuse affiche les trois dernières notifications de vignette large.	string	No
fallback	Modèle à utiliser si le nom du modèle principal n’est pas reconnu par le destinataire, pour une utilisation avec Windows 8 compatibilité. Cette valeur est le nom Windows 8 de la valeur dans l’attribut template. Les nouveaux modèles introduits après Windows 8 n’ont pas de secours.	tileTemplateNameV1 (voir remarques)	Non	None
Lang	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 ceux dans le visuel, mais peuvent être substitués par celui dans le texte. 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 utilise par défaut les paramètres régionaux choisis par Windows Runtime lors de la résolution de la chaîne. Consultez Remarques pour savoir si cette valeur n’est pas spécifiée.	string	Non	None
template	Un des modèles fournis sur lesquels baser la vignette. En règle générale, un développeur doit fournir un format carré et un format large, chacun sous forme d’élément de liaison distinct. Les entrées valides sont membres de l’énumération tileTemplateType .	tileTemplateNameV2 (voir remarques)	Oui	None

Éléments enfants

Élément enfant	Description
image	Spécifie une image utilisée dans le modèle de vignette. L’image fournie doit correspondre aux exigences de taille et de forme pour le modèle ou l’image spécifique dans ce modèle.
text	Spécifie le texte utilisé dans le modèle de vignette.

Éléments parents

Élément parent	Description
visuel	Contient plusieurs éléments enfants de liaison , chacun définissant une vignette.

Remarques

La valeur tileTemplateNameV2 utilisée dans l’attribut template peut être l’une des valeurs de chaîne suivantes. Pour plus d’informations sur chaque modèle, consultez Le catalogue de modèles de vignettes.

TileSquare150x150Block
TileSquare150x150Image
TileSquare150x150PeekImageAndText01
TileSquare150x150PeekImageAndText02
TileSquare150x150PeekImageAndText03
TileSquare150x150PeekImageAndText04
TileSquare150x150Text01
TileSquare150x150Text02
TileSquare150x150Text03
TileSquare150x150Text04
TileSquare310x310BlockAndText01
TileSquare310x310BlockAndText02
TileSquare310x310Image
TileSquare310x310ImageAndText01
TileSquare310x310ImageAndText02
TileSquare310x310ImageAndTextOverlay01
TileSquare310x310ImageAndTextOverlay02
TileSquare310x310ImageAndTextOverlay03
TileSquare310x310ImageCollection
TileSquare310x310ImageCollectionAndText01
TileSquare310x310ImageCollectionAndText02
TileSquare310x310SmallImagesAndTextList01
TileSquare310x310SmallImagesAndTextList02
TileSquare310x310SmallImagesAndTextList03
TileSquare310x310SmallImagesAndTextList04
TileSquare310x310Text01
TileSquare310x310Text02
TileSquare310x310Text03
TileSquare310x310Text04
TileSquare310x310Text05
TileSquare310x310Text06
TileSquare310x310Text07
TileSquare310x310Text08
TileSquare310x310TextList01
TileSquare310x310TextList02
TileSquare310x310TextList03
TileWide310x150BlockAndText01
TileWide310x150BlockAndText02
TileWide310x150Image
TileWide310x150ImageAndText01
TileWide310x150ImageAndText02
TileWide310x150ImageCollection
TileWide310x150PeekImage01
TileWide310x150PeekImage02
TileWide310x150PeekImage03
TileWide310x150PeekImage04
TileWide310x150PeekImage05
TileWide310x150PeekImage06
TileWide310x150PeekImageAndText01
TileWide310x150PeekImageAndText02
TileWide310x150PeekImageCollection01
TileWide310x150PeekImageCollection02
TileWide310x150PeekImageCollection03
TileWide310x150PeekImageCollection04
TileWide310x150PeekImageCollection05
TileWide310x150PeekImageCollection06
TileWide310x150SmallImageAndText01
TileWide310x150SmallImageAndText02
TileWide310x150SmallImageAndText03
TileWide310x150SmallImageAndText04
TileWide310x150SmallImageAndText05
TileWide310x150Text01
TileWide310x150Text02
TileWide310x150Text03
TileWide310x150Text04
TileWide310x150Text05
TileWide310x150Text06
TileWide310x150Text07
TileWide310x150Text08
TileWide310x150Text09
TileWide310x150Text10
TileWide310x150Text11

La valeur tileTemplateNameV1 utilisée dans l’attribut de secours peut être l’une des valeurs de chaîne suivantes. Il s’agit des noms de modèles Windows 8. Pour plus d’informations sur chaque modèle, consultez Le catalogue de modèles de vignettes.

TileSquareBlock
TileSquareImage
TileSquarePeekImageAndText01
TileSquarePeekImageAndText02
TileSquarePeekImageAndText03
TileSquarePeekImageAndText04
TileSquareText01
TileSquareText02
TileSquareText03
TileSquareText04
TileWideBlockAndText01
TileWideBlockAndText02
TileWideImage
TileWideImageAndText01
TileWideImageAndText02
TileWideImageCollection
TileWidePeekImage01
TileWidePeekImage02
TileWidePeekImage03
TileWidePeekImage04
TileWidePeekImage05
TileWidePeekImage06
TileWidePeekImageAndText01
TileWidePeekImageAndText02
TileWidePeekImageCollection01
TileWidePeekImageCollection02
TileWidePeekImageCollection03
TileWidePeekImageCollection04
TileWidePeekImageCollection05
TileWidePeekImageCollection06
TileWideSmallImageAndText01
TileWideSmallImageAndText02
TileWideSmallImageAndText03
TileWideSmallImageAndText04
TileWideSmallImageAndText05
TileWideText01
TileWideText02
TileWideText03
TileWideText04
TileWideText05
TileWideText06
TileWideText07
TileWideText08
TileWideText09
TileWideText10
TileWideText11

Le tableau suivant explique comment le système répond lorsque lang n’est pas spécifié.

Pré...	Réponse du système
Langue de la notification	S’il est défini explicitement, utilisez visual.lang ou binding.lang Sinon, le paramètre de langue spécifique à l’application (la langue, le cas échéant, que le [Système de gestion des ressources](/previous-versions/windows/apps/jj552947(v=win.10)) détermine que l’application s’exécutera en fonction du profil de langue actuel) Sinon, la langue du nom d’affichage sur la vignette est résolue par Windows Runtime Sinon, la langue de l’interface utilisateur de l’interpréteur de commandes (muI) Ce langage influence principalement la disposition des colonnes dans les modèles qui présentent des colonnes.
Éléments de texte avec du texte littéral	S’il est défini explicitement, utilisez visual.lang ou binding.lang Sinon, le paramètre de langue spécifique à l’application (la langue, le cas échéant, que le [Système de gestion des ressources](/previous-versions/windows/apps/jj552947(v=win.10)) détermine que l’application s’exécutera en fonction du profil de langue actuel) Sinon, la langue du nom d’affichage sur la vignette est résolue par Windows Runtime Sinon, la langue de l’interface utilisateur de l’interpréteur de commandes (muI)
Éléments de texte avec contenu ms-resource	Si elle est définie explicitement, utilisez visual.lang ou binding.lang, et la langue explicite est ajoutée à la liste des langues [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) du système de gestion des ressources utilisé pour résoudre la chaîne Sinon, le [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) utilisé comme initialisé avec le profil de langue de l’utilisateur Une fois la chaîne résolue, la langue de la chaîne résolue est affectée à l’élément de texte. Cette langue forme l’alignement du texte (LTR et RTL) et la sélection de la police pour l’interface utilisateur.
ms-appx :/// image	Si elle est définie explicitement, utilisez visual.lang ou binding.lang, la langue explicite est ajoutée à la liste de langues [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) du système de gestion des ressources utilisé pour résoudre la chaîne Sinon, le [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) us utilisé comme initialisé avec le profil de langue de l’utilisateur
Images cloud	S’il est défini explicitement, utilisez visual.lang ou binding.lang Sinon, le paramètre de langue spécifique à l’application (la langue, le cas échéant, dans laquelle le [système de gestion des ressources](/previous-versions/windows/apps/jj552947(v=win.10)) détermine que l’application s’exécutera en fonction du profil de langue actuel) Sinon, la langue du nom d’affichage sur la vignette telle qu’elle est résolue par Windows Runtime (peut ne pas être définie si le nom est indépendant de la langue) Sinon, la langue de l’interface utilisateur de l’interpréteur de commandes (muI) Ce langage est inclus dans la chaîne de requête si addImageQuery a la valeur true.

Configuration requise

	Valeur
Espace de noms	`http://schemas.microsoft.com/notifications/2012/tile.xsd`

Partager via