Idioma: HTML | XAML

Como nomear recursos usando qualificadores (XAML)

Applies to Windows and Windows Phone

Você pode dar nome aos recursos usando qualificadores. Os qualificadores identificam o contexto em que uma versão de um recurso deve ser usada.

Qualificadores de recursos

Você pode personalizar os recursos de arquivo e cadeia de caracteres para dar suporte a várias escalas de exibição, idiomas da interface do usuário, configurações de alto contraste e muito mais. Os qualificadores de recursos são modificadores de pasta e nome de arquivo que identificam o contexto em que uma determinada versão de um recurso deve ser usada.

A convenção de nomenclatura padrão é

foldername/qualifiername-value_qualifiername-value/filename.qualifiername-value_qualifiername-value.ext

Por exemplo,

Images/en-US/homeregion-USA/logo.scale-100_contrast-white.png

é carregada fazendo referência a

Images/logo.png

Observação  Nós recomendamos que você marque o idioma padrão nos arquivos de recursos de cadeia de caracteres (como en-US\resources.resw) e a escala padrão nas imagens (como logo.scale-100.png), mesmo que não seja preciso localizar esses arquivos nem fornecer imagens com múltiplas resoluções.

Nomes de pastas inteiros são analisados para ver se há qualificadores. Os nomes de pastas são relacionados a um conjunto de qualificadores ou são considerados parte do caminho de arquivos lógico. O segmento pontilhado no arquivo imediatamente anterior à extensão do arquivo é considerado um token que indica os qualificadores. Vários qualificadores são separados por um caractere de sublinhado, e os qualificadores são tradicionalmente especificados com seus nomes e valores (com exceção do idioma quando usados em um nome de pasta).

Os desenvolvedores de aplicativos podem optar por usar nomes de pasta ou de arquivo para especificar os ativos para um determinado conjunto de contextos ou uma combinação das duas estratégias, dependendo do fluxo de trabalho.

O recurso correto é automaticamente escolhido na hora da execução, com base no qualificador de cada recurso e no contexto atual. Por exemplo, você pode fornecer os seguintes ativos:

en-us\logo.scale-100.png
en-us\logo.scale-140.png
fr-fr\logo.png

Um usuário que prefere inglês (EUA) em um computador com escala 140 verá a imagem en-us\logo.scale-140.png. Para obter detalhes sobre a seleção de recursos em cenários mais complexos de fallback, veja Contexto de Recursos.

As demais seções deste tópico contêm informações detalhadas sobre o conjunto de qualificadores e seus possíveis valores para cada dimensão compatível com a infraestrutura do recurso.

Idioma (idioma do aplicativo)

O qualificador de idioma especifica o idioma BCP-47 do recurso. Os nomes de arquivo requerem o qualificador "lang" ou "language" junto com a marca de idioma, mas as pastas precisam apenas da marca de idioma. Para obter uma lista de idiomas, veja Registro da subtag de idioma IANA.

Formatos de nome de pasta:

<Any BCP-47 language tag>
lang-<Any BCP-47 language tag>
language-<Any BCP-47 language tag>

Formatos de nome de arquivo:

lang-<Any BCP-47 language tag>
language-<Any BCP-47 language tag>

Exemplos:

es-MX/resources.resw
language-de-DE/UI.resw
images/logo.lang-fr-FR.png

O qualificador de idioma é comparado à lista de idiomas do aplicativo. As alterações no idioma do aplicativo na hora da execução são propagadas como eventos (veja ResourceContext.QualifierValues). Um aplicativo não precisa definir ou substituir o idioma.

Escala

O qualificador de escala especifica o fator de escala do recurso. Ele costuma ser usado para imagens visualizadas em um dispositivo com DPI alta ou quando o aplicativo é visualizado com zoom. A escala de um recurso corresponde ao valor de Windows.Graphics.Display.DisplayProperties.ResolutionScale ou ao próximo recurso com a maior dimensão. Se usar o qualificador de escala em um recurso, você não deverá usar o qualificador targetsize.

scale-80 (only valid for resources specified in the app manifest)
scale-100
scale-140
scale-180

As alterações na escala na hora da execução são propagadas como eventos (veja ResourceContext.QualifierValues).

Contraste

O qualificador de contraste especifica a configuração do tema de alto contraste do sistema. A opção "Padrão" é usada quando todos os temas de alto contraste estão desabilitados. A opção "Alto" é válida em qualquer modo de alto contraste. A opção "Preto" representa a situação em que as imagens com tela de fundo preta e primeiro plano branco são preferenciais. A opção "Branco" representa a situação em que as imagens com tela de fundo branca e primeiro plano preto são preferenciais. As configurações de tema Alto Contraste 1 e Alto Contraste 2 correspondem ao valor do qualificador "Preto".

contrast-standard
contrast-high
contrast-black
contrast-white

Região residencial

O qualificador de região residencial representa a localização residencial do usuário. Normalmente é especificado na instalação do Windows e pode ser acessado pelo Painel de Controle. Geralmente, esse qualificador (ResourceContext.QualifierValues) é substituído quando há algum outro provedor de dados para a localização. O valor pode ser qualquer marca de região BCP-47 válida, ou seja, qualquer código de região de duas letras iso-3166-1 alpha 2, mais o conjunto de códigos geográficos de três dígitos para regiões compostas iso-3166-1 numeric (veja a seção sobre a Norma de composição de códigos de região M49 da Divisão de Estatísticas das Nações Unidas.) Observe que os códigos para "Indicadores econômicos selecionados e outros agrupamentos" não são válidos.

Formato:

homeregion-<Region Code>

Exemplos:

homeregion-us
homeregion-jp
homeregion-419

O qualificador de região residencial corresponde a qualquer região composta pai.

Tamanho do alvo

O qualificador targetsize pode ser usado para especificar recursos de um determinado tamanho (em pixels). É usado principalmente para especificar ícones de associação de tipo de arquivo ou ícones de protocolo exibidos no Windows Explorer da área de trabalho. Esse qualificador costuma ser usado para imagens ou ícones quadrados e especifica uma única dimensão de imagem. O sistema ou aplicativo que solicita o recurso (ResourceContext.QualifierValues) deve especificar explicitamente um tamanho de alvo. Não há um padrão. Se usar o qualificador targetsize em um recurso, você não deve usar o qualificador de escala.

Formato:

targetsize-<any positive integer>

Exemplos:

targetsize-16
targetsize-96

O contexto de tamanho do alvo corresponde ao próximo recurso com a maior qualificação.

Direção do layout

Use o qualificador de layout para especificar os recursos que aplicam o direcionamento de alinhamento de texto e ordem de leitura específicos. Por exemplo, uma imagem pode precisar ser espelhada para um idioma com leitura da direita para a esquerda como árabe ou hebraico. A maioria dos aplicativos pode usar mecanismos de inversão automática para espelhar imagens na hora da execução; porém, esse qualificador é para os casos em que a simples inversão não é adequada. Para saber mais, veja Como ajustar o layout para idiomas com leitura da direita para a esquerda e localizar fontes.

Exemplos:

layoutdir-RTL
layoutdir-LTR
layoutdir-TTBRTL
layoutdir-TTBLTR

Configuração

Use o qualificador de configuração para especificar os recursos aplicáveis apenas a um determinado ambiente de hora de criação, como recursos somente de teste. Não é usado pela maioria dos desenvolvedores de aplicativos. A variável de ambiente MS_CONFIGURATION_ATTRIBUTE_VALUE pode ser definida para o valor da cadeia de caracteres que foi atribuída aos recursos relevantes (como "teste").

Exemplos:

config-test
config-designer

Forma alternativa

O qualificador de forma alternativa pode ser usado para fornecer uma forma alternativa de um recurso para alguma finalidade específica. Normalmente é usado apenas por desenvolvedores de aplicativos em japonês para fornecer uma cadeia de caracteres furigana, para a qual o valor "msft-phonetic" é reservado. O sistema ou aplicativo deve fornecer um valor para usar esse qualificador em determinadas situações. Não há um padrão. Não use o prefixo "msft-" para seus próprios valores personalizados.

Formato:

altform-<Any string between 1 and 16 chars>

Exemplos:

altform-msft-phonetic
altform-myapp-special

Nível de recursos do DirectX

O qualificador de nível de recurso DirectX representa o nível de recurso DirectX de adaptadores gráficos que serão usados para renderizar o recurso. Ele é geralmente usado para ativos de exibição Direct3D usados em jogos. O nível de recurso DirectX de um recurso corresponderá a um valor definido explicitamente em um Contexto de Recurso pelo aplicativo. Se um recurso com exatamente o mesmo valor de nível de recurso DX não estiver disponível, será usado o recurso com o próximo valor mais baixo disponível.

Observação  O qualificador de nível de recurso DirectX tem suporte a partir do Windows 8.1.

Há dois formatos possíveis para o qualificador de nível de recurso DirectX. Os valores com suporte são DX9, DX10 e DX11.

Formato 1:

DXFeatureLevel-<value>

Exemplo:

DXFeatureLevel-DX10

Formato 2:

DXFL-<value>

Exemplo:

DXFL-DX11

Tópicos relacionados

Diretrizes de dimensionamento de acordo com a densidade de pixels
Oferecendo suporte a temas de alto contraste
Como gerenciar idioma e região
Como ajustar o layout para idiomas com leitura da direita para a esquerda e localizar fontes
Como se preparar para a localização
Como atribuir um ícone personalizado a um tipo de arquivo
Adicionando ícones, visualizações e menus de atalhos
Windows.ApplicationModel.Resources.Core.ResourceContext.QualifierValues
Windows.Graphics.Display.DisplayProperties.ResolutionScale
Links externos
A marca de idioma BCP-47
Registro da submarca de idioma IANA
Norma de composição de códigos de região M49 da Divisão de Estatísticas das Nações Unidas

 

 

Mostrar:
© 2014 Microsoft