ApplicationLanguages.PrimaryLanguageOverride | primaryLanguageOverride Property

Obtient ou définit une substitution pour la langue par défaut de l'application, exprimée comme une balise de langue BCP-47. Ce paramètre est persistant.

Syntaxe

Public Shared Property PrimaryLanguageOverride As String
   Get
   Set

Valeur de la propriété

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Balise de langue BCP 47. L'application peut la définir pour remplacer la langue de la liste classée des langues par défaut de l'utilisateur (ApplicationLanguages.Languages), et sa valeur sera active entre les sessions d'application. Ce doit être une seule balise de langue. Une liste délimitée de balises de langue échouera.

Lorsque votre application obtient la valeur, PrimaryLanguageOverride retourne une seule balise de langage (si votre application a défini la propriété précédemment) ou une chaîne vide.

Remarques

Les applications s'exécutent normalement avec les paramètres de langue déterminés par le système en comparant les langues prises en charge par l'application aux préférences de langue de l'utilisateur. Les paramètres pour ce comportement du système peut être obtenu à l'aide de la propriété ApplicationLanguages.Languages. La propriété PrimaryLanguageOverride permet de substituer ce comportement en définissant une langue spécifique comme première langue dans la liste des langues.

Le paramètre PrimaryLanguageOverride est persistant entre les sessions. Elle ne doit pas être définie chaque fois que l'application est chargée. Elle ne doit être définie qu'en fonction de l'entrée utilisateur présentée dans l'interface utilisateur des paramètres. La propriété peut être lue à tout moment. Si la propriété n'a jamais été définie, elle retourne une chaîne vide.

Lorsque vous définissez PrimaryLanguageOverride, cela est immédiatement répercuté dans la propriété ApplicationLanguages.Languages. Toutefois, cette modification peut ne pas prendre effet immédiatement sur les ressources chargées dans l'interface utilisateur de l'application. Afin de vous assurer que l'application répondra à de telles modifications, écoutez la propriété QualifierValues sur un contexte de ressources par défaut et prenez les mesures qui s'imposent pour recharger les ressources. Ces spécifications peuvent varier selon l'infrastructure de l'interface utilisateur utilisée par l'application et il peut s'avérer nécessaire de redémarrer l'application.

Remarque  Si votre application passe des balises de langue entre cette classe et les fonctions NLS (National Language Support), elle doit d'abord convertir les balises en appelant ResolveLocaleName.

À compter de Windows 8.1 :

Les balises de langue peuvent prendre en charge les extensions Unicode. Consultez les notes de la classe ApplicationLanguages.

Les applications Windows Store peuvent être déployées à l'aide de packages de ressources. Lorsque vous utilisez des packages de ressources de langue, les packages qui sont installés et inscrits pour un utilisateur donné sont déterminés par les langues indiquées dans le profil linguistique de l'utilisateur. Par conséquent, toutes les langues incluses dans le lot d'applications qui a été envoyé au Windows Store ne seront pas forcément disponibles au moment de l'exécution. La propriété PrimaryLanguageOverride doit être définie aux langues uniquement disponibles à l'utilisateur.

Les langues disponibles pour l'application à utiliser comme un objet ApplicationLanguages lors de l'exécution sont limitées aux langues incluses dans le manifeste du package de l'application principale, ainsi que les langues correspondant aux packages de ressources linguistiques qui sont applicables à l'utilisateur (déterminés par les langues de correspondance dans les préférences utilisateur) et qui sont installés et enregistrés pour l'utilisateur. La propriété ApplicationLanguages.ManifestLanguages reflète les paquets de ressources linguistiques disponibles pour l'utilisateur, et par conséquent retourne un ensemble approprié de langues qui peuvent être utilisées pour définir la propriété PrimaryLanguageOverride.

La propriété ApplicationLanguages.Languages retourne une liste très similaire à la propriété ManifestLanguages. Elle peut différer en incluant des variations linguistiques régionales non répertoriées dans un manifeste du package. Par exemple, "en-CA" (anglais (Canada)) peut être retourné par la propriété Languages si l'utilisateur a "en-CA" dans son profil et que l'application prend en charge toutes les variations régionales de l'anglais. Ces variations de paramètres régionaux dérivés de l'utilisateur peuvent être préférables pour définir la propriété PrimaryLanguageOverride puisque l'application fournit des comportements de globalisation plus appropriés pour l'utilisateur.

Si une langue figure dans le package principal de l'application mais ne correspond à aucune langue des préférences utilisateur, elle est retournée par la propriété ManifestLanguages mais pas par la propriété Languages. Celles-ci peuvent également être utilisées pour définir la propriété PrimaryLanguageOverride. Toutefois, puisque ces langues n'existent pas dans les préférences utilisateur, celui-ci peut ne pas les comprendre. Ces paramètres doivent être utilisés uniquement une fois choisis directement par l'utilisateur.

Conditions requises

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.Globalization
Windows::Globalization [C++]

Métadonnées

Windows.winmd

Voir aussi

ApplicationLanguages
ApplicationLanguages.Languages
Balises de langue BCP 47

 

 

Afficher:
© 2014 Microsoft