Função GetKeyboardLayout (winuser.h)

Artigo
03/13/2024

Recupera o identificador de localidade de entrada ativo (anteriormente chamado de layout de teclado).

Sintaxe

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

Parâmetros

[in] idThread

Tipo: DWORD

O identificador do thread a ser consultado ou 0 para o thread atual.

Retornar valor

Tipo: HKL

O valor retornado é o identificador de localidade de entrada para o thread. A palavra baixa contém um Identificador de Idioma para o idioma de entrada e a palavra alta contém um identificador de dispositivo para o layout físico do teclado.

Comentários

O identificador de localidade de entrada é um conceito mais amplo do que um layout de teclado, pois também pode abranger um conversor de fala em texto, um método de entrada Editor (IME) ou qualquer outra forma de entrada.

Como o layout do teclado pode ser alterado dinamicamente, os aplicativos que armazenam informações em cache sobre o layout do teclado atual devem processar a mensagem WM_INPUTLANGCHANGE para serem informados sobre as alterações no idioma de entrada.

Para obter o KLID (ID de layout do teclado) do HKL ativo no momento, chame GetKeyboardLayoutName.

Começando no Windows 8: o método preferencial para recuperar o idioma associado ao layout de teclado atual ou ao método de entrada é uma chamada para Windows.Globalization.Language.CurrentInputMethodLanguageTag. Se seu aplicativo passar marcas de idioma de CurrentInputMethodLanguageTag para qualquer função de Suporte a Idioma Nacional , ele deverá primeiro converter as marcas chamando ResolveLocaleName.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll