Language Classe

Définition

Espace de noms:

Windows.Globalization

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.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.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

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Voir aussi

• Exemple OCR (Windows 10)
• Exemple de préférences de globalisation (Windows 10)