Escopo de tradução para texto localizado

A tradução de texto localizado depende da sessão da interface do usuário e da localidade atual.

Visão geral

A tradução de variáveis

LocalizedText

depende do idioma da sessão e ocorre somente em uma sessão da interface do usuário com reconhecimento de localidade.

Uma sessão da interface do usuário com reconhecimento de localidade usa entradas de

DicionárioDeLocalização

para a localidade atual. Objetos fora da sessão da interface do usuário não usam a localidade da sessão atual.

As regras a seguir descrevem o comportamento da tradução na sessão da interface do usuário e na sessão raiz:

A tradução se aplica somente em sessões da interface do usuário com reconhecimento de localidade.

Strings literais não são traduzidas automaticamente.

O texto é traduzido somente quando corresponde a uma entrada de localização.

Objetos fora da sessão da interface do usuário usam a localidade da sessão raiz.

A localidade da sessão raiz é inglês por padrão.

Os objetos e contextos a seguir usam a localidade da sessão atual para tradução.

Objetos e contextos traduzíveis
Item	Descrição
Objeto de interface do usuário, como um rótulo ou caixa de texto, com um link para uma chave em DicionárioDeLocalização	O objeto é executado na sessão da interface do usuário e usa a localidade atual. O objeto Interface do usuário exibe texto traduzido quando a chave vinculada tem uma entrada para a localidade atual.
Objeto Interface do usuário com um conversor FormatadorDeStrings e uma propriedade Format vinculada a uma chave de DicionárioDeLocalização	Se um objeto gráfico usa um FormatadorDeStrings , a interface do usuário traduz o conteúdo quando a propriedade Format corresponde a uma entrada do dicionário. Esse comportamento dá suporte à estrutura de sentença específica da localidade. Por exemplo, uma localidade pode usar Value: {0} , e outra localidade pode usar {0}：値 .
Objeto Interface do usuário vinculado a uma variável de modelo do tipo LocalizedText com um link para uma chave de dicionário de localização	O objeto Interface do usuário exibe a tradução para a localidade atual quando o valor da variável corresponde a uma entrada de dicionário de localização.

Os objetos e contextos a seguir não usam a localidade da sessão atual para tradução.

Objetos e contextos intraduzíveis
Item	Descrição
Valores de string literais, independentemente de sua localização no projeto	Se uma variável de modelo contiver uma string literal, a string não será traduzida automaticamente em tempo de execução. Esse comportamento não altera com a localidade padrão do projeto.
Qualquer variável sem uma entrada direta no dicionário de localização, independentemente de sua localização no projeto ou tipo de dados	Variáveis sem uma entrada de dicionário de localização não são traduzidas. Por exemplo, um rótulo com texto hello sem um mapeamento de dicionário permanece inalterado.
Variável do tipo LocalizedText que usa um conversor FormatadorDeStrings e uma propriedade localizada Format fora de um objeto Interface do usuário	Se a propriedade Format corresponder a uma chave de localização, mas a variável estiver fora de um objeto Interface do usuário, a tradução não ocorrerá. Não se aplica a alguns objetos, por exemplo: Alarmes, RegistradorDeEventos, Relatórios.

Dê sua opinião

Tem dúvidas ou comentários sobre esta documentação? Por favor, envie seu comentário aqui.