Prise en charge des notifications par vignette et toast pour la langue, l’échelle et le contraste élevé

  • Article

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 savoir comment utiliser des qualificateurs dans les noms de vos fichiers de ressources, consultez Personnaliser vos ressources en fonction de la langue, de l’échelle et d’autres qualificateurs, ainsi que des icônes et logos d’application.

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

Faire référence à une ressource de chaîne à partir d’un modèle

Dans votre modèle de vignette ou de 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 des chaînes dans votre manifeste de package d’interface utilisateur et d’application.

C’est ainsi qu’une référence à l’identificateur de ressource de chaîne « Farewell » se présenterait 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 de toast, vous pouvez faire référence à une ressource image à l’aide du ms-appx schéma URI (Identificateur de ressource uniforme) 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 une autre ressource à 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 (comme chemin d’accès 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 « :// » qui est suivi d’un chemin d’accès absolu (un chemin absolu commence par « / »).

Hébergement et chargement d’images dans le cloud

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

Ajoutez plutôt à l’URI de votre image une chaîne de requête décrivant la 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 sur true dans la charge utile XML de notification de vignette ou de toast . L’attribut addImageQuery apparaît dans les visualéléments , bindinget image des schémas vignette et toast. La définition explicite de addImageQuery sur un élément remplace toute valeur définie sur un ancêtre. Par instance, une valeur addImageQuery de true dans un image élément remplace une valeur addImageQuery de false dans son élément parentbinding.

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

Qualificateur Chaîne de requête Exemple
Scale ms-scale ?ms-scale=400
Langage ms-lang ?ms-lang=en-US
Comparez 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