GetKeyboardLayout-Funktion (winuser.h)

Artikel
03/13/2024

Ruft den aktiven Eingabegebietsgebietsbezeichner (früher als Tastaturlayout bezeichnet) ab.

Syntax

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

Parameter

[in] idThread

Art: DWORD

Der Bezeichner des abzufragenden Threads oder 0 für den aktuellen Thread.

Rückgabewert

Typ: HKL

Der Rückgabewert ist der Eingabegebietsgebietsbezeichner für den Thread. Das niedrige Wort enthält einen Sprachbezeichner für die Eingabesprache, und das hohe Wort enthält ein Gerätehandle zum physischen Layout der Tastatur.

Hinweise

Der Eingabegebietsschemabezeichner ist ein umfassenderes Konzept als ein Tastaturlayout, da er auch einen Spracherkennungskonverter, eine Eingabemethode Editor (IME) oder jede andere Form der Eingabe umfassen kann.

Da das Tastaturlayout dynamisch geändert werden kann, sollten Anwendungen, die Informationen zum aktuellen Tastaturlayout zwischenspeichern, die WM_INPUTLANGCHANGE Nachricht verarbeiten, um über Änderungen in der Eingabesprache informiert zu werden.

Rufen Sie getKeyboardLayoutName auf, um die KLID (Tastaturlayout-ID) der derzeit aktiven HKL abzurufen.

Ab Windows 8: Die bevorzugte Methode zum Abrufen der Sprache, die dem aktuellen Tastaturlayout oder der Eingabemethode zugeordnet ist, ist ein Aufruf von Windows.Globalization.Language.CurrentInputMethodLanguageTag. Wenn Ihre App Sprachtags von CurrentInputMethodLanguageTag an Alle Funktionen zur Unterstützung von Nationaler Sprache übergibt, muss sie zuerst die Tags konvertieren, indem ResolveLocaleName aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll