GetKeyboardLayout, fonction (winuser.h)

Récupère l’identificateur de paramètres régionaux d’entrée actif (anciennement appelé disposition du clavier).

Syntaxe

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

Paramètres

[in] idThread

Type : DWORD

Identificateur du thread à interroger, ou 0 pour le thread actuel.

Valeur retournée

Type : HKL

La valeur de retour est l’identificateur de paramètres régionaux d’entrée pour le thread. Le mot bas contient un identificateur de langue pour la langue d’entrée et le mot haut contient un handle d’appareil à la disposition physique du clavier.

Remarques

L’identificateur de paramètres régionaux d’entrée est un concept plus large qu’une disposition de clavier, car il peut également englober un convertisseur de reconnaissance vocale, un éditeur de méthode d’entrée (IME) ou toute autre forme d’entrée.

Étant donné que la disposition du clavier peut être modifiée dynamiquement, les applications qui mettez en cache des informations sur la disposition de clavier actuelle doivent traiter le message WM_INPUTLANGCHANGE pour être informées des modifications apportées à la langue d’entrée.

Pour obtenir le KLID (ID de disposition du clavier) du HKL actif, appelez getKeyboardLayoutName.

À partir de Windows 8 : La méthode préférée pour récupérer la langue associée à la disposition du clavier ou à la méthode d’entrée actuelle est un appel à Windows.Globalization.Language.CurrentInputMethodLanguageTag. Si votre application transmet des balises de langue de CurrentInputMethodLanguageTag à des fonctions de support linguistique national , elle doit d’abord convertir les balises en appelant ResolveLocaleName.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll

Voir aussi

ActivateKeyboardLayout

Conceptuel

CreateThread

Entrées du clavier

LoadKeyboardLayout

Autres ressources

Référence

WM_INPUTLANGCHANGE