Suporte à notificação de bloco e do sistema para o idioma, a escala e o alto contraste

  • Artigo

Seu blocos e notificações do sistema podem carregar cadeias de caracteres e imagens personalizadas para idioma de exibição, fator de escala de exibição, alto contraste e outros contextos de tempo de execução. Para obter informações sobre como usar qualificadores nos nomes dos arquivos de recurso, consulte Personalizar seus recursos para idioma, escala e outros qualificadores e Ícones e logotipos do aplicativo.

Para obter mais informações sobre a proposta de valor de localização do aplicativo, consulte Globalização e localização.

Refere-se a um recurso de cadeia de caracteres de um modelo

Em seu modelo de bloco ou notificação do sistema, você pode consultar um recurso de cadeia de caracteres usando o esquema URI (Uniform Resource Identifier) de ms-resource seguido por um identificador de recurso de cadeia de caracteres simples. Por exemplo, se você tiver um arquivo Resources.resx que contém uma entrada de recurso cujo nome é "Farewell", você tem um recurso de cadeia de caracteres com o identificador "Farewell". Para obter mais informações sobre identificadores de recurso de cadeia de caracteres e Arquivos de recurso (.resw), consulte Localizar cadeias de caracteres em sua IU e manifesto do pacote de aplicativo.

É assim que uma referência para o identificador de recurso de cadeia de caracteres "Farewell" ficaria no corpo de texto de seu modelo de conteúdo, usando ms-resource.

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

Se você omitir o esquema de URI do ms-resource, então o corpo de texto é apenas uma cadeia de caracteres literal, e não uma referência a um identificador.

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

Refere-se a um recurso de imagem de um modelo

Em seu modelo de bloco ou notificação do sistema, você pode consultar um recurso de imagem usando o esquema URI (Uniform Resource Identifier) de ms-appx seguido pelo nome do recurso de imagem. É assim também que você fará referência a um recurso de imagem na marcação XAML (para obter mais detalhes, consulte Fazer referência a uma imagem ou outro ativo no código e na marcação XAML).

Por exemplo, você pode nomear pastas desta forma.

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

Nesse caso, você tem um recurso de imagem única e seu nome (como um caminho absoluto) é /Assets/Images/welcome.png. Veja como usar esse nome em seu modelo.

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

Observe como neste exemplo o URI do esquema ("ms-appx") é seguido por "://" que é seguido por um caminho absoluto (um caminho absoluto começa com "/").

Hospedar e carregar imagens na nuvem

Os esquemas URI de ms-resource e ms-appx realizam a correspondência de qualificador automática para localizar o recurso que é mais apropriado para o contexto atual. Esquemas URI da Web (por exemplo, http, https e ftp) não executam quaisquer correspondências automáticas.

Em vez disso, acrescente no URI da imagem uma cadeia de caracteres de consulta que descreve o valor ou valores do qualificador solicitado.

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

Em seguida, no serviço de aplicativo que fornece suas imagens, implemente um manipulador de HTTP que inspeciona e usa a cadeia de caracteres de consulta para determinar qual imagem devolver.

Você também precisa definir o atributo addImageQuery para true na carga XML de notificação do bloco ou sistema. O atributo addImageQuery aparece nos visualelementos , bindinge image dos esquemas do bloco e do sistema. Definir explicitamente addImageQuery em um elemento substituirá o valor definido em um ancestral. Por exemplo, um valor addImageQuery de true em um elemento de image substitui um addImageQuery de false em seu elemento binding pai.

Estas são as cadeias de caracteres de consulta que você pode usar.

Qualificador Cadeia de consulta Exemplo
Escala ms-scale ?ms-scale=400
Linguagem ms-lang ?ms-lang=en-US
Contraste ms-contrast ?ms-contrast=high

Para obter uma tabela de referência de todos os valores de qualificador possíveis que você pode usar em suas cadeias de caracteres de consulte, veja ResourceContext.QualifierValues.

APIs importantes