Language Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Uma classe que fornece informações relacionadas a marcas de idioma BCP-47 , como o nome do idioma e o script.
public ref class Language sealed/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ILanguageFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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 Language final/// [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)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ILanguageFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class Language final[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ILanguageFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 sealed class Language[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)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ILanguageFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Languagefunction Language(languageTag)Public NotInheritable Class Language- Herança
- 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)
|
Exemplos
// Get the top user-preferred language and its display name.
var topUserLanguage = Windows.System.UserProfile.GlobalizationPreferences.Languages[0];
var language = new Windows.Globalization.Language(topUserLanguage);
var displayName = language.DisplayName;
Comentários
Se seu aplicativo passar marcas de idioma usadas nessa classe para qualquer função de Suporte a Idioma Nacional , ele deverá primeiro converter as marcas chamando ResolveLocaleName.
Inicialize essa classe com uma marca de idioma BCP-47 . Por exemplo, para trabalhar com o melhor idioma preferencial do usuário atual, passe o valor superior de Windows.System.UserProfile.GlobalizationPreferences:
As marcas de idioma 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 calendário usado pelos objetos Calendar.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1803 | 17134 | LayoutDirection |
| 2004 | 19041 | AbbreviatedName |
| 2004 | 19041 | GetMuiCompatibleLanguageListFromLanguageTags |
Construtores
| Language(String) |
Cria um objeto Language . |
Propriedades
| AbbreviatedName |
Obtém a abreviação de três letras para uma marca de idioma BCP-47. Por exemplo, "en-US" é convertido em "eng". |
| CurrentInputMethodLanguageTag |
Obtém a marca de idioma BCP-47 para o layout de teclado atualmente habilitado ou o IME (Editor de Método de Entrada). |
| DisplayName |
Obtém uma cadeia de caracteres localizada que é adequada para exibição ao usuário para identificar o idioma. |
| LanguageTag |
Obtém a marca de idioma BCP-47 normalizada para esse idioma. |
| LayoutDirection |
Obtém a direção do layout do conteúdo (para elementos de texto e interface do usuário) mais apropriada para um idioma. |
| NativeName |
Obtém o nome do idioma no próprio idioma. |
| Script |
Obtém o código de script ISO 15924 de quatro letras do idioma. |
Métodos
| GetExtensionSubtags(String) |
Recupera um vetor de submarcas de extensão no idioma atual para a extensão determinada identificada por singleton. |
| GetMuiCompatibleLanguageListFromLanguageTags(IIterable<String>) |
Recupera um conjunto de marcas MUI (Interface do Usuário Multilíngue) derivadas de uma ou mais marcas de idioma BCP-47. |
| IsWellFormed(String) |
Determina se uma marca de idioma BCP-47 está bem formada. |
| TrySetInputMethodLanguageTag(String) |
Tenta definir a marca de idioma BCP-47 normalizada deste idioma. |