Función GetKeyboardLayout (winuser.h)

Artículo
03/04/2024

Recupera el identificador de configuración regional de entrada activo (anteriormente denominado diseño de teclado).

Sintaxis

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

Parámetros

[in] idThread

Tipo: DWORD

Identificador del subproceso que se va a consultar o 0 para el subproceso actual.

Valor devuelto

Tipo: HKL

El valor devuelto es el identificador de configuración regional de entrada para el subproceso. La palabra baja contiene un identificador de idioma para el idioma de entrada y la palabra alta contiene un identificador de dispositivo para el diseño físico del teclado.

Comentarios

El identificador de configuración regional de entrada es un concepto más amplio que un diseño de teclado, ya que también puede abarcar un convertidor de voz a texto, un método de entrada Editor (IME) o cualquier otra forma de entrada.

Puesto que el diseño del teclado se puede cambiar dinámicamente, las aplicaciones que almacenan en caché la información sobre el diseño del teclado actual deben procesar el mensaje WM_INPUTLANGCHANGE para informarse de los cambios en el idioma de entrada.

Para obtener el KLID (id. de diseño de teclado) del HKL activo actualmente, llame a GetKeyboardLayoutName.

A partir de Windows 8: el método preferido para recuperar el idioma asociado al diseño de teclado o al método de entrada actual es una llamada a Windows.Globalization.Language.CurrentInputMethodLanguageTag. Si la aplicación pasa etiquetas de idioma de CurrentInputMethodLanguageTag a cualquier función de compatibilidad con lenguaje nacional , primero debe convertir las etiquetas mediante una llamada a ResolveLocaleName.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll