Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
Aplicativos Canvas Copilot Studio Fluxos de ambiente de trabalho Funções do Power Platform CLI Dataverse Power Pages
Devolve a etiqueta de idioma do utilizador atual.
Descrição
A Language função retorna o idioma, o script e a região do usuário atual como uma marca de idioma.
Utilize as informações de idioma para personalizar a sua aplicação em regiões. Por exemplo, se você estiver criando um aplicativo usado na Itália e na França, poderá usar Language para exibir automaticamente cadeias de caracteres em italiano e francês para seus usuários nesses locais diferentes.
Language Etiquetas
A etiqueta de idioma pode estar num destes três formatos:
| Valor devolvido | Descrição |
|---|---|
| "lg-RE" | lg é a abreviatura de dois caracteres para o idioma e RE é a abreviatura de dois caracteres para a região. É o tipo de retorno mais comum. Por exemplo, "en-GB" é devolvido para o Reino Unido. |
| "LG" | LG é a abreviatura de dois caracteres para a língua. É o formato usado quando o Power Apps tem informações sobre o idioma, mas não tem informações para a região específica. |
| "lg-scrp-RE" | lg é a abreviatura de dois caracteres para a língua, scrp é a abreviatura de quatro caracteres para o script, e RE é a abreviatura de dois caracteres para a região. |
O Power Apps utiliza o formato etiqueta de idioma IETF BCP-47.
Para ver a lista de marcas de idioma suportadas, digite Value("1",) na barra de fórmulas ou no modo de exibição avançado e role pela lista de localidades sugeridas para o segundo argumento.
As funções Text e Value também utilizam as etiquetas de idioma. Utilize estas funções para traduzir de e para cadeias de texto de uma forma globalmente consciente. Ao passar uma tag de idioma para essas funções e a região não fizer diferença, você pode usar apenas a parte de idioma da tag.
Sintaxe
Language()
Exemplos
Região do utilizador
Presume-se que o sistema operacional do host e/ou o navegador estejam usando a localidade padrão para o local.
| Fórmula | Localização | Valor Devolvido |
|---|---|---|
| Language() | Lisboa, Portugal | "pt-PT" |
| Language() | Rio de Janeiro, Brasil | "pt-BR" |
| Language() | Atlanta, E.U.A. | "en-US" |
| Language() | Manchester, Reino Unido | "en-GB" |
| Language() | Paris, França | "fr-FR" |
| Language() | Roseau, Dominica | "en" |
| Language() | Belgrado, Sérvia | "sr-cyrl-RS" ou "sr-latn-RS", dependendo das configurações do sistema do usuário |
Tabela de localização
Uma abordagem simples à localização consiste em criar uma folha de cálculo em Excel mapeando um TextID definido pelo utilizador para um texto traduzido para o idioma do utilizador. Embora você possa usar uma coleção ou qualquer outra fonte de dados para esta tabela, escolhemos o Excel porque é fácil de editar e gerenciar fora do aplicativo por tradutores.
Crie a seguinte tabela no Excel:
A entrada com espaço em branco para a Language coluna é usada como padrão se não houver nenhuma cadeia de texto específica encontrada para um determinado idioma. Esta entrada deve aparecer após todas as outras entradas para um determinado TextID.
Para as nossas finalidades, necessitamos apenas de verificar o idioma da região e não a região. Se as considerações regionais fossem importantes, poderíamos incluir o valor completo da tag de idioma na tabela acima.
Utilize o friso Inserir, o comando Tabela, para incluí-lo numa tabela Excel adequada. Por padrão, ela é chamada de Tabela1 , mas você pode nomeá-la como quiser com a faixa de opções Ferramentas de Tabela/Design e a caixa de texto Nome da Tabela: no lado esquerdo.
Guarde o ficheiro do Excel no sistema de ficheiros local.
Em Power Apps, no painel direito, clique ou toque no separador Origens de Dados e, em seguida, clique ou toque em Adicionar origem de dados.
Clique ou toque em Adicionar dados estáticos à sua aplicação, clique ou toque no ficheiro Excel que guardou e, em seguida, clique ou toque em Abrir.
Selecione a tabela que criou e, em seguida, clique ou toque em Ligar.
No seu aplicativo, onde quer que você tenha usado o texto "Olá" antes, use esta fórmula:
- LookUp( Table1, TextID = "Olá" && (LanguageTag = Left( Language(), 2 ) || IsBlank( LanguageTag ))). Texto localizado
Esta fórmula procurará o valor LocalizedText apropriado para o idioma do utilizador e, se este não for encontrado, recorrerá à versão em branco predefinida.
As cadeias de caracteres traduzidas em outros idiomas podem ser mais longas do que no seu idioma. Em muitos casos, os rótulos e outros elementos que exibem as cadeias de caracteres na interface do usuário precisam ser mais amplos para acomodar.
Serviço de tradução
Pode traduzir texto a pedido utilizando um serviço de tradução, como o serviço Microsoft Translator:
- No Power Apps, no painel da direita, clique ou toque no separador Origem de Dados e, em seguida, clique ou toque em Adicionar origem de dados.
- Clique ou toque em Microsoft Translator.
Na sua aplicação, onde quer que tenha utilizado o texto "Hello" anteriormente, em vez disso, utilize esta fórmula:
- MicrosoftTranslator.Translate( "Olá", Language() )
O serviço Microsoft Translator usa as mesmas marcas de idioma que a Language função retorna.
Essa abordagem vem com algumas desvantagens quando comparada ao exemplo anterior, que utilizou uma tabela pré-traduzida de cadeias de texto:
- A tradução leva tempo para ser concluída, exigindo uma chamada para um serviço em toda a rede. Isso resulta em um atraso para ver o texto traduzido em seu aplicativo.
- A tradução é mecânica e pode não ser o que você espera ou ser a melhor escolha para a situação dentro do seu aplicativo.