text (toast XML Schema)

  • Article

Spécifie le texte utilisé dans le modèle toast.

Hiérarchie d’éléments

<Toast>
<visuel>
<binding>
<Texte>

Syntax

<text id    = integer
      lang? = string 
      placement? = "attribution"
      hint-callScenarioCenterAlign? = boolean />

Clé :

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
id

Élément text dans le modèle toast auquel ce texte est destiné. Si un modèle n’a qu’un seul élément de texte, cette valeur est 1. Le nombre de positions de texte disponibles est basé sur la définition du modèle.

 entier Oui 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 tous les autres paramètres régionaux spécifiés dans la liaison ou le 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 utilise par défaut les paramètres régionaux choisis par Windows Runtime lors de la résolution de la chaîne.

 string Non None
Placement

Placement du texte. Introduit dans la mise à jour anniversaire. Si vous spécifiez la valeur « attribution », le texte s’affiche toujours en bas de votre notification, ainsi que l’identité de votre application ou l’horodatage de la notification. Sur les versions antérieures de Windows qui ne prennent pas en charge le texte d’attribution, le texte est simplement affiché en tant qu’autre élément de texte (en supposant que vous ne disposez pas déjà du maximum de trois éléments de texte). Pour plus d’informations, consultez Contenu toast.

 string Non None
hint-callScenarioCenterAlign

Définissez sur « true » pour centrer le texte des notifications d’appel entrantes. Cette valeur est utilisée uniquement pour les notifications avec avec la valeur de scénario « incomingCall » ; sinon, elle est ignorée. Pour plus d’informations, consultez Contenu toast.

 boolean Non Aucun

 

Éléments enfants

Aucune.

Éléments parents

Élément parent Description
binding

Spécifie le modèle toast. Notez qu’un seul élément de liaison peut être inclus dans une notification toast.

 

Remarques

Le corps de l’élément de texte peut être exprimé de deux manières :

  • Sous forme de chaîne littérale ; pour instance, <text id="1">Hello world !</text>.
  • Comme référence de chaîne, à l’aide du préfixe « ms-resource » ; pour instance, <text id="1 »> ms-resource :hello</text>. Lorsque vous utilisez le préfixe « ms-resource », l’identificateur de chaîne est référencé dans le fichier Resources.resjson (application Windows utilisant JavaScript) ou Resources.resw de l’application (C#/C++).

Pour plus d’informations, consultez Globalisation de votre vignette : localisation, mise à l’échelle et accessibilité.

Voir aussi