liaison (schéma de vignette)

  • Article

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