Compartilhar via


ApplicationLanguages Classe

Definição

Especifica as preferências relacionadas ao idioma que o aplicativo pode usar e manter.

public ref class ApplicationLanguages abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ApplicationLanguages final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class ApplicationLanguages
Public Class ApplicationLanguages
Herança
Object Platform::Object IInspectable ApplicationLanguages
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Os idiomas referenciados nessa classe são representados por marcas de idioma BCP-47. Cada um deles é um identificador de linguagem e não um nome de localidade, embora os dois estruturalmente possam ser os mesmos. Como uma marca de idioma, "en-US" significa inglês americano (ou o dialeto do inglês falado no Estados Unidos). Ele não faz nenhuma declaração sobre a localização real dos palestrantes (embora muitos deles residam nos EUA) e nenhuma outra declaração sobre convenções que são usadas nos EUA, como o sistema de medição ou a moeda.

Exemplo:

Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverride = "en-US"

Observação

Se o aplicativo passar marcas de idioma dessa classe para qualquer função de Suporte à Linguagem Nacional , ele deverá primeiro converter as marcas chamando ResolveLocaleName.

As marcas de linguagem dão suporte às extensões Unicode "ca-" e "nu-". (Consulte Definições de chave/tipo Unicode.) Observe que essas extensões podem afetar o sistema numeral ou o calendário usado por objetos de globalização.

Os aplicativos UWP podem ser implantados usando pacotes de recursos. Quando pacotes de recursos de linguagem são usados, os pacotes instalados e registrados para um determinado usuário são determinados pelos idiomas no perfil de idioma do usuário. Como resultado, nem todos os idiomas incluídos no pacote de aplicativos enviados à Microsoft Store estarão necessariamente disponíveis para uso em runtime. A propriedade PrimaryLanguageOverride só deve ser definida como idiomas disponíveis para o usuário.

Os idiomas disponíveis para o aplicativo usar como um objeto ApplicationLanguages em runtime são limitados aos idiomas incluídos no manifesto do pacote de aplicativos main e aos idiomas correspondentes aos pacotes de recursos de idioma aplicáveis ao usuário (determinados por idiomas correspondentes nas preferências do usuário) e que são instalados e registrados para o usuário. A propriedade ApplicationLanguages.ManifestLanguages reflete os pacotes de recursos de linguagem disponíveis para o usuário e retorna um conjunto apropriado de idiomas que podem ser usados para definir a propriedade PrimaryLanguageOverride .

A propriedade ApplicationLanguages.Languages retornará uma lista muito semelhante à propriedade ManifestLanguages . Pode ser diferente ao incluir variações de linguagem regionais não listadas em nenhum manifesto de pacote; por exemplo, "en-CA" (Inglês (Canadá)) poderá ser retornado pela propriedade Languages se o usuário tiver "en-CA" em seu perfil e o aplicativo oferecer suporte a qualquer variedade regional de inglês. Essas variações de linguagem regionais derivadas do usuário podem ser preferíveis para definir a propriedade PrimaryLanguageOverride , pois o aplicativo fornecerá comportamentos de globalização mais apropriados para o usuário.

Se um idioma estiver no pacote main aplicativo, mas não for uma correspondência para qualquer idioma na preferência do usuário, ele será retornado pela propriedade ManifestLanguages, mas não pela propriedade Languages. Eles também podem ser usados para definir a propriedade PrimaryLanguageOverride . No entanto, como esses idiomas não são refletidos nas preferências do usuário, o usuário pode não entender esses idiomas. Essas configurações devem ser usadas somente quando escolhidas diretamente pelo usuário.

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1803 17134 GetLanguagesForUser

Propriedades

Languages

Obtém uma lista classificada de valores de linguagem de runtime atuais preferidos pelo usuário.

ManifestLanguages

Obtém a lista declarada do aplicativo de idiomas com suporte.

PrimaryLanguageOverride

Obtém ou define uma substituição para o idioma preferido do aplicativo, expresso como uma marca de idioma BCP-47 . Essa configuração é persistente.

Métodos

GetLanguagesForUser(User)

Recupera as preferências de idioma do usuário especificado. Essa API faz parte do suporte para MUA (aplicativos multiusuário).

Aplica-se a

Confira também