Prise en charge des notifications de vignettes et toasts pour la langue, la mise à l’échelle et le contraste élevé

  • Article

Remarque

Les vignettes Vie sont une fonctionnalité Windows 10 qui n’est pas prise en charge sur les versions ultérieures de Windows. Pour les nouvelles applications, nous vous recommandons de suivre les instructions actuelles pour les icônes d’application.

Vos vignettes et toasts peuvent charger des chaînes et des images adaptées à la langue d’affichage, au facteur d’échelle d’affichage, au contraste élevé et à d’autres contextes d’exécution. Pour plus d’informations sur l’utilisation de qualificateurs dans les noms de vos fichiers de ressources, consultez Personnaliser vos ressources pour la langue, la mise à l’échelle et d’autres qualificateurs et icônes d’application.

Pour plus d’informations sur la proposition de valeur de la localisation de votre application, consultez Internationalisation et localisation.

Reportez-vous à une ressource de chaîne à partir d’un modèle

Dans votre modèle de vignette ou toast, vous pouvez faire référence à une ressource de chaîne à l’aide du ms-resource schéma URI (Uniform Resource Identifier) suivi d’un identificateur de ressource de chaîne simple. Par exemple, si vous avez un fichier Resources.resx qui contient une entrée de ressource dont le nom est « Farewell », vous disposez d’une ressource de chaîne avec l’identificateur « Farewell ». Pour plus d’informations sur les identificateurs de ressources de chaîne et les fichiers de ressources (.resw), consultez Localiser les chaînes dans votre manifeste de package d’interface utilisateur et d’application.

Il s’agit de la façon dont une référence à l’identificateur de ressource de chaîne « Farewell » ressemblerait dans le corps du texte de votre contenu de modèle, à l’aide ms-resourcede .

<text id="1">ms-resource:Farewell</text>

Si vous omettez le ms-resource schéma d’URI, le corps du texte n’est qu’un littéral de chaîne et non une référence à un identificateur.

<text id="1">Farewell</text>

Reportez-vous à une ressource d’image à partir d’un modèle

Dans votre modèle de vignette ou toast, vous pouvez faire référence à une ressource d’image à l’aide du ms-appx schéma URI (Uniform Resource Identifier) suivi du nom de la ressource d’image. Il s’agit de la même façon que vous faites référence à une ressource d’image dans le balisage XAML (pour plus d’informations, consultez Référencer une image ou un autre élément multimédia à partir du balisage ET du code XAML).

Par exemple, vous pouvez nommer des dossiers comme celui-ci.

\Assets\Images\contrast-standard\welcome.png
\Assets\Images\contrast-high\welcome.png

Dans ce cas, vous avez une seule ressource d’image et son nom (en tant que chemin absolu) est /Assets/Images/welcome.png. Voici comment utiliser ce nom dans votre modèle.

<image id="1" src="ms-appx:///Assets/Images/welcome.png"/>

Notez que dans cet exemple d’URI, le schéma («ms-appx ») est suivi de «:// » suivi d’un chemin absolu (un chemin absolu commence par «/ »).

Hébergement et chargement d’images dans le cloud

Les ms-resource schémas et ms-appx URI effectuent des correspondances de qualificateur automatique pour rechercher la ressource la plus appropriée pour le contexte actuel. Les schémas d’URI web (par exemple, http, httpset ftp) n’effectuent aucune correspondance automatique.

Ajoutez plutôt à l’URI de votre image une chaîne de requête décrivant la valeur ou les valeurs de qualificateur demandées.

<image id="1" src="http://www.contoso.com/Assets/Images/welcome.png?ms-lang=en-US"/>

Ensuite, dans le service d’application qui fournit vos images, implémentez un gestionnaire HTTP qui inspecte et utilise la chaîne de requête pour déterminer l’image à retourner.

Vous devez également définir l’attribut addImageQuery dans la charge utile XML de notification toast ou de vignette.true L’attribut addImageQuery apparaît dans les bindingvisualimage éléments de la vignette et des schémas toast. La définition explicite d’addImageQuery sur un élément remplace toute valeur définie sur un ancêtre. Par exemple, une valeur addImageQuery d’un image true élément remplace un addImageQuery de false son élément parentbinding.

Il s’agit des chaînes de requête que vous pouvez utiliser.

Qualificateur Chaîne de requête Exemple
Mise à l’échelle ms-scale ?ms-scale=400
Langage ms-lang ?ms-lang=en-US
Contraste ms-contrast ?ms-contrast=high

Pour obtenir une table de référence de toutes les valeurs de qualificateur possibles que vous pouvez utiliser dans vos chaînes de requête, consultez ResourceContext.QualifierValues.

API importantes