Funzione GetKeyboardLayout (winuser.h)

Articolo
03/13/2024

Recupera l'identificatore delle impostazioni locali di input attivo (in precedenza denominato layout della tastiera).

Sintassi

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

Parametri

[in] idThread

Tipo: DWORD

Identificatore del thread da eseguire su query o 0 per il thread corrente.

Valore restituito

Tipo: HKL

Il valore restituito è l'identificatore delle impostazioni locali di input per il thread. La parola bassa contiene un identificatore di lingua per la lingua di input e la parola alta contiene un handle del dispositivo per il layout fisico della tastiera.

Commenti

L'identificatore delle impostazioni locali di input è un concetto più ampio di un layout della tastiera, poiché può anche includere un convertitore voce-a-testo, un metodo di input Editor (IME) o qualsiasi altra forma di input.

Poiché il layout della tastiera può essere modificato in modo dinamico, le applicazioni che memorizzano nella cache le informazioni sul layout della tastiera corrente devono elaborare il messaggio di WM_INPUTLANGCHANGE per essere informati delle modifiche nel linguaggio di input.

Per ottenere l'ID di layout della tastiera (KLID) dell'HKL attualmente attivo, chiamare GetKeyboardLayoutName.

A partire da Windows 8: il metodo preferito per recuperare la lingua associata al layout o al metodo di input corrente è una chiamata a Windows.Globalization.Language.CurrentInputMethodLanguageTag. Se l'app passa tag di lingua da CurrentInputMethodLanguageTag a qualsiasi funzione di supporto linguistico nazionale, deve prima convertire i tag chiamando ResolveLocaleName.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll