GetKeyboardLayout, fonction (winuser.h)

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

Syntaxe

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

Paramètres

[in] idThread

Type : DWORD

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

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, une méthode d’entrée Rédacteur (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 actuelle du clavier 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 actuellement actif, appelez getKeyboardLayoutName.

À compter de Windows 8 : la méthode par défaut 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 à n’importe quelle fonction de prise en charge des langues nationales , elle doit d’abord convertir les balises en appelant ResolveLocaleName.

Configuration requise

Condition requise Valeur
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