Fonction SetThreadUILanguage (winnls.h)

Article
08/27/2023

Définit la langue de l’interface utilisateur pour le thread actuel.

Windows Vista et versions ultérieures : Cette fonction ne peut pas effacer la liste des langues d’interface utilisateur préférées des threads. Votre application MUI doit appeler SetThreadPreferredUILanguages pour effacer la liste des langues.

Windows XP : Cette fonction se limite à permettre au système d’exploitation d’identifier et de définir une valeur à utiliser en toute sécurité sur la console Windows.

Syntaxe

LANGID SetThreadUILanguage(
  [in] LANGID LangId
);

Paramètres

[in] LangId

Identificateur de langue pour la langue de l’interface utilisateur pour le thread.

Windows Vista et versions ultérieures : L’application peut spécifier un identificateur de langue de 0 ou un identificateur différent de zéro. Pour plus d'informations, consultez la section Notes.

Windows XP : L’application peut uniquement définir ce paramètre sur 0. Ce paramètre permet à la fonction de sélectionner la langue qui prend le mieux en charge l’affichage de la console. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Retourne l’identificateur de langue d’entrée en cas de réussite. Si l’identificateur d’entrée est différent de zéro, la fonction retourne cette valeur. Si l’identificateur de langue est 0, la fonction réussit toujours et retourne l’identificateur de la langue qui prend le mieux en charge la console Windows. Consultez la section Notes.

Si l’identificateur de langue d’entrée est différent de zéro et que la fonction échoue, la valeur de retour diffère de l’identificateur de langue d’entrée. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError.

Remarques

Lorsqu’un thread est créé, le paramètre de langue de l’interface utilisateur du thread est vide et l’interface utilisateur du thread s’affiche dans la langue sélectionnée par l’utilisateur. Cette fonction permet à l’application de modifier la langue de l’interface utilisateur pour le thread en cours d’exécution.

Windows Vista et versions ultérieures : L’appel de cette fonction et la spécification de 0 pour l’identificateur de langue est identique à l’appel de SetThreadPreferredUILanguages avec le jeu d’indicateurs MUI_CONSOLE_FILTER. Si l’application spécifie un identificateur de langue différente de zéro valide, la fonction définit une langue d’interface utilisateur particulière pour le thread. Après avoir spécifié 0 pour l’identificateur de langue, l’application ne peut utiliser aucune des constantes suivantes pour correspondre à un identificateur de langue :

Windows XP : Lorsque l’application appelle cette fonction avec un identificateur de langue de 0, la fonction vérifie d’abord que l’interface utilisateur actuelle ne nécessite pas Uniscribe et qu’elle est prise en charge par la page de code de la console. Si l’interface utilisateur réussit ces tests, la fonction utilise la valeur fournie. Si ce n’est pas le cas, la fonction change la langue de l’interface utilisateur du thread en une langue que la console Windows peut afficher. Windows XP ne prend pas en charge un concept de langage d’interface utilisateur de thread distinct des paramètres régionaux de thread. Par conséquent, cette fonction modifie les paramètres régionaux du thread sur Windows XP. Il est facile pour votre application de définir un thread pour utiliser la langue la plus appropriée pour l’affichage de la console, en fonction des langues d’interface utilisateur préférées de l’utilisateur et du système, du langage des applications non Unicode et des fonctionnalités de la console.

C# Signature

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.UInt16 SetThreadUILanguage(
            System.UInt16 LangId
            );

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winnls.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

GetThreadUILanguage

Interface utilisateur multilingue

Fonctions d’interface utilisateur multilingues

SetThreadPreferredUILanguages

Partager via