Partager via


Language Classe

Définition

Classe qui fournit des informations relatives aux balises de langue BCP-47 , telles que le nom de la langue et le 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 Language
function Language(languageTag)
Public NotInheritable Class Language
Héritage
Object Platform::Object IInspectable Language
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

// 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;

Remarques

Si votre application transmet les balises de langue utilisées dans cette classe à n’importe quelle fonction de prise en charge des langues nationales , elle doit d’abord convertir les balises en appelant ResolveLocaleName.

Initialisez cette classe avec une balise de langue BCP-47 . Par exemple, pour utiliser la meilleure langue actuelle préférée par l’utilisateur, transmettez la valeur supérieure de Windows.System.UserProfile.GlobalizationPreferences :

Les balises de langue prennent en charge les extensions Unicode « ca- » et « nu- ». (Voir Définitions de clé/type Unicode.) Notez que ces extensions peuvent affecter le calendrier utilisé par les objets Calendar.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1803 17134 LayoutDirection
2004 19041 AbbreviatedName
2004 19041 GetMuiCompatibleLanguageListFromLanguageTags

Constructeurs

Language(String)

Crée un objet Language .

Propriétés

AbbreviatedName

Obtient l’abréviation à trois lettres d’une balise de langue BCP-47. Par exemple, « en-US » est converti en « eng ».

CurrentInputMethodLanguageTag

Obtient la balise de langue BCP-47 pour la disposition du clavier ou l’éditeur de méthode d’entrée (IME) actuellement activé.

DisplayName

Obtient une chaîne localisée qui convient à l’affichage pour l’utilisateur afin d’identifier la langue.

LanguageTag

Obtient la balise de langue BCP-47 normalisée pour cette langue.

LayoutDirection

Obtient le sens de disposition du contenu (pour les éléments de texte et d’interface utilisateur) le plus approprié pour une langue.

NativeName

Obtient le nom de la langue dans la langue elle-même.

Script

Obtient le code de script ISO 15924 à quatre lettres du langage.

Méthodes

GetExtensionSubtags(String)

Récupère un vecteur de sous-balises d’extension dans la langue actuelle pour l’extension donnée identifiée par singleton.

GetMuiCompatibleLanguageListFromLanguageTags(IIterable<String>)

Récupère un ensemble de balises d’interface utilisateur multilingue (MUI) dérivées d’une ou plusieurs balises de langue BCP-47.

IsWellFormed(String)

Détermine si une balise de langue BCP-47 est bien formée.

TrySetInputMethodLanguageTag(String)

Tente de définir la balise de langue BCP-47 normalisée de cette langue.

S’applique à

Voir aussi