GetKeyboardLayout, fonction (winuser.h)

Article
03/04/2024

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