Partager via

image (Schéma XML Toast)

  • Article

Spécifie une image utilisée dans le modèle toast.

Hiérarchie d’éléments

<Toast>
<visuel>
<binding>
<Image>

Syntax

<image id             = integer
       src            = string
       alt?           = string
       addImageQuery? = boolean 
       placement? = "appLogoOverride" | "hero"
       hint-crop? = "circle" />

Clé :

? facultatif (zéro ou un)

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 toast. 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, valeur de

« www.website.com/images/hello.png »

donné dans la notification devient

« www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us »

 boolean Non false
alt

Description de l’image, pour les utilisateurs de technologies d’assistance.

 string Non None
id

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

 entier Oui None
src

URI de la source d’image, à l’aide de l’un des gestionnaires de protocole suivants :

  • http:// ou https://

    Image web.

  • ms-appx:///

    Image incluse dans le package d’application.

  • ms-appdata :///local/

    Image enregistrée dans le stockage local.

  • Fichier:///

    Image locale. (Pris en charge uniquement pour les applications de bureau. Ce protocole ne peut pas être utilisé par les applications UWP.)

 string Oui None
Placement

Emplacement de l’image.

  • « appLogoOverride » : l’image remplace le logo de votre application dans la notification toast.
  • « hero » - L’image est affichée sous forme d’image de héros.

Pour plus d’informations, consultez Contenu Toast.

 string Non None
hint-crop

Rognage de l’image.

  • « cercle » : l’image est rognée dans un cercle.
  • Non spécifié : l’image n’est pas rognée et affichée sous forme de carré.

Pour plus d’informations, consultez Contenu Toast.

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

Voir aussi