Compatibilidad con notificaciones del icono y del sistema para el idioma, la escala y el contraste alto

  • Artículo

Los iconos y las notificaciones del sistema pueden cargar cadenas e imágenes adaptadas para el lenguaje de visualización, el factor de escala de pantalla, el contraste alto y otros contextos en tiempo de ejecución. Para obtener información sobre cómo usar calificadores en los nombres de los archivos de recursos, consulte Personalización de los recursos para idiomas, escalado y otros calificadores y logotipos de la aplicación.

Para más información sobre la propuesta de valor de localizar la aplicación, consulta Globalización y localización.

Consulte un recurso de cadena desde una plantilla.

En la plantilla del icono o del sistema, puede hacer referencia a un recurso de cadena mediante el ms-resource esquema URI (identificador uniforme de recursos) seguido de un identificador de recurso de cadena simple. Por ejemplo, si tiene un archivo Resources.resx que contiene una entrada de recurso cuyo nombre es "Adiós", tiene un recurso de cadena con el identificador "Adiós". Para obtener más información sobre los identificadores de recursos de cadena y los archivos de recursos (.resw), consulta Localizar cadenas en el manifiesto del paquete de la aplicación y la interfaz de usuario.

Así es como una referencia al identificador de recurso de cadena "Adiós" buscaría en el cuerpo de texto del contenido de la plantilla, mediante ms-resource.

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

Si omite el ms-resource esquema de URI, el cuerpo del texto es simplemente un literal de cadena y no una referencia a un identificador.

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

Consulte un recurso de imagen desde una plantilla.

En la plantilla de icono o notificación del sistema, puede hacer referencia a un recurso de imagen mediante el ms-appx esquema URI (identificador uniforme de recursos) seguido del nombre del recurso de imagen. Esta es la misma manera que haces referencia a un recurso de imagen en el marcado XAML (para obtener más detalles, consulta Hacer referencia a una imagen u otro recurso de marcado XAML y código).

Por ejemplo, podría asignar un nombre a carpetas como esta.

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

En ese caso, tiene un único recurso de imagen y su nombre (como ruta de acceso absoluta) es /Assets/Images/welcome.png. Aquí se muestra cómo se usa ese nombre en la plantilla.

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

Observe cómo en este URI de ejemplo, el esquema ("ms-appx") va seguido de "://", seguido de una ruta de acceso absoluta (una ruta de acceso absoluta comienza por "/").

Hospedaje y carga de imágenes en la nube

Los ms-resource esquemas de URI y ms-appx realizan la coincidencia automática de calificadores para buscar el recurso más adecuado para el contexto actual. Los esquemas de URI web (por ejemplo, http, httpsy ftp) no realizan ninguna coincidencia automática de este tipo.

En su lugar, anexe al URI de la imagen una cadena de consulta que describe el valor o los valores del calificador solicitados.

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

A continuación, en el servicio de aplicaciones que proporciona las imágenes, implemente un controlador HTTP que inspeccione y use la cadena de consulta para determinar qué imagen se va a devolver.

También debe establecer el atributo trueaddImageQuery en en la carga XML de notificación del icono o notificación del sistema. El atributo addImageQuery aparece en los visualelementos , bindingy image de los esquemas del icono y del sistema. Al establecer explícitamente addImageQuery en un elemento, se invalida cualquier valor establecido en un antecesor. Por ejemplo, un valor addImageQuery de true en un image elemento invalida un addImageQuery de false en su elemento primario binding .

Estas son las cadenas de consulta que puede usar.

Calificador: Cadena de consulta Ejemplo
Escala ms-scale ?ms-scale=400
Lenguaje ms-lang ?ms-lang=en-US
Compare ms-contrast ?ms-contrast=high

Para obtener una tabla de referencia de todos los valores de calificador posibles que puede usar en las cadenas de consulta, consulte ResourceContext.QualifierValues.

API importantes