ApplicationLanguages Classe

Définition

Espace de noms:

Windows.Globalization

Spécifie les préférences linguistiques que l’application peut utiliser et gérer.

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

Héritage

Object Platform::Object IInspectable ApplicationLanguages

Attributs

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)

Remarques

Les langues référencées dans cette classe sont représentées par des balises de langue BCP-47. Chacun d’eux est un identificateur de langue et non un nom de paramètres régionaux, bien que les deux structurellement puissent être identiques. En tant que balise de langue, « en-US » signifie l’anglais américain (ou le dialecte de l’anglais parlé dans le États-Unis). Il ne fait aucune revendication sur l’emplacement réel des orateurs (bien que beaucoup d’entre eux résident aux États-Unis) et aucune autre revendication sur les conventions utilisées aux États-Unis, telles que le système de mesure ou la devise.

Exemple :

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

Remarque

Si votre application transmet des balises de langue de cette classe à des fonctions de support linguistique national , elle doit d’abord convertir les balises en appelant ResolveLocaleName.

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

Les applications UWP peuvent être déployées à l’aide de packages de ressources. Lorsque des packages de ressources linguistiques sont utilisés, les packages installés et inscrits pour un utilisateur donné sont déterminés par les langues dans le profil linguistique de l’utilisateur. Par conséquent, toutes les langues incluses dans l’offre groupée d’applications qui a été envoyée au Microsoft Store ne seront pas nécessairement disponibles pour une utilisation au moment de l’exécution. La propriété PrimaryLanguageOverride doit être définie uniquement sur les langues disponibles pour l’utilisateur.

Les langues disponibles pour l’application à utiliser en tant qu’objet ApplicationLanguages au moment de l’exécution sont limitées aux langues incluses dans le manifeste du package d’application main et aux langues correspondant aux packages de ressources linguistiques applicables à l’utilisateur (déterminées par les langues correspondantes dans les préférences de l’utilisateur), qui sont installées et inscrites pour l’utilisateur. La propriété ApplicationLanguages.ManifestLanguages reflète les packages de ressources de langue disponibles pour l’utilisateur et retourne un ensemble de langues approprié qui peut être utilisé pour définir la propriété PrimaryLanguageOverride .

La propriété ApplicationLanguages.Languages renvoie une liste très similaire à la propriété ManifestLanguages . Il peut différer par l’inclusion de variantes linguistiques régionales non répertoriées dans un manifeste de package ; Par exemple, « en-CA » (anglais (Canada)) peut être retourné par la propriété Langues si l’utilisateur a « en-CA » dans son profil et que l’application prend en charge n’importe quelle variété régionale d’anglais. Ces variantes de langue régionales dérivées de l’utilisateur peuvent être préférables pour définir la propriété PrimaryLanguageOverride , car l’application fournira ensuite des comportements de globalisation plus appropriés pour l’utilisateur.

Si une langue se trouve dans le package d’application main mais qu’elle ne correspond à aucune langue de la préférence de l’utilisateur, elle est retournée par la propriété ManifestLanguages, mais pas par la propriété Langues. Vous pouvez également les utiliser pour définir la propriété PrimaryLanguageOverride . Toutefois, étant donné que ces langues ne sont pas reflétées dans les préférences de l’utilisateur, il peut ne pas comprendre ces langues. Ces paramètres doivent être utilisés uniquement lorsqu’ils sont choisis directement par l’utilisateur.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1803	17134	GetLanguagesForUser

Propriétés

Languages	Obtient une liste classée des valeurs de langage d’exécution actuelles préférées par l’utilisateur.
ManifestLanguages	Obtient la liste déclarée de l’application des langues prises en charge.
PrimaryLanguageOverride	Obtient ou définit un remplacement pour la langue préférée de l’application, exprimé sous la forme d’une balise de langue BCP-47 . Ce paramètre est conservé.

Méthodes

GetLanguagesForUser(User)

Récupère les préférences linguistiques de l’utilisateur spécifié. Cette API fait partie de la prise en charge des applications multi-utilisateurs (MUA).

Voir aussi

• Balises de langue BCP-47
• Définitions de clé/type Unicode