Función LoadKeyboardLayoutA (winuser.h)
Carga un nuevo identificador de configuración regional de entrada (anteriormente denominado diseño de teclado) en el sistema.
antes de Windows 8: se pueden cargar varios identificadores de configuración regional de entrada a la vez, pero solo uno por proceso está activo a la vez. Cargar varios identificadores de configuración regional de entrada permite cambiar rápidamente entre ellos.
a partir de Windows 8: El identificador de configuración regional de entrada se carga para todo el sistema. Esta función no tiene ningún efecto si el proceso actual no posee la ventana con el foco del teclado.
Sintaxis
HKL LoadKeyboardLayoutA(
[in] LPCSTR pwszKLID,
[in] UINT Flags
);
Parámetros
[in] pwszKLID
Tipo: LPCTSTR de
Nombre del identificador de configuración regional de entrada que se va a cargar. Este nombre es una cadena compuesta por el valor hexadecimal del identificador de idioma (palabra baja) y un identificador de dispositivo (palabra alta). Por ejemplo, inglés de EE. UU. tiene un identificador de idioma de 0x0409, por lo que el diseño principal inglés de EE. UU. se denomina "00000409". Las variantes del diseño inglés estadounidense (como el diseño Dvorak) se denominan "00010409", "00020409", etc.
Para obtener una lista de los diseños de entrada que se proporcionan con Windows, consulte identificadores de teclado y editores de métodos de entrada para Windows.
[in] Flags
Tipo: UINT
Especifica cómo se va a cargar el identificador de configuración regional de entrada. Este parámetro puede ser uno o varios de los siguientes valores.
| Valor | Significado |
|---|---|
|
Antes de Windows 8: Si el identificador de configuración regional de entrada especificado aún no está cargado, la función carga y activa el identificador de configuración regional de entrada para el subproceso actual.
a partir de Windows 8: Si el identificador de configuración regional de entrada especificado aún no está cargado, la función carga y activa el identificador de configuración regional de entrada para el sistema. |
|
a partir de Windows 8: En este escenario, se establece el último identificador de configuración regional de entrada para todo el sistema. |
|
Antes de Windows 8: Mueve el identificador de configuración regional de entrada especificado al encabezado de la lista de identificadores de configuración regional de entrada, lo que hace que ese identificador de configuración regional sea el identificador de configuración regional activo para el subproceso actual. Este valor reordena la lista de identificadores de configuración regional de entrada incluso si no se proporciona KLF_ACTIVATE.
a partir de Windows 8: Mueve el identificador de configuración regional de entrada especificado al encabezado de la lista de identificadores de configuración regional de entrada, lo que hace que ese identificador de configuración regional sea el identificador de configuración regional activo para el sistema. Este valor reordena la lista de identificadores de configuración regional de entrada incluso si no se proporciona KLF_ACTIVATE. |
|
Si el nuevo identificador de configuración regional de entrada tiene el mismo identificador de idioma que un identificador de configuración regional de entrada actual, el nuevo identificador de configuración regional de entrada reemplaza al actual como identificador de configuración regional de entrada para ese idioma. Si no se proporciona este valor y los identificadores de configuración regional de entrada tienen los mismos identificadores de idioma, el identificador de configuración regional de entrada actual no se reemplaza y la función devuelve NULL. |
|
Sustituye el identificador de configuración regional de entrada especificado por otra configuración regional preferida por el usuario. El sistema comienza con este conjunto de marcas y se recomienda que la aplicación use siempre esta marca. La sustitución solo se produce si la clave del Registro HKEY_CURRENT_USER\Keyboard Layout\Substitutes define explícitamente una configuración regional de sustitución. Por ejemplo, si la clave incluye el nombre de valor "00000409" con el valor "00010409", cargar el diseño de EE. UU. ("00000409") hace que el diseño de United States-Dvorak ("00010409") se cargue en su lugar. El sistema usa KLF_SUBSTITUTE_OK al arrancar y se recomienda que todas las aplicaciones usen este valor al cargar identificadores de configuración regional de entrada para asegurarse de que está seleccionada la preferencia del usuario. |
|
antes de Windows 8: Esta marca solo es válida con KLF_ACTIVATE. Activa el identificador de configuración regional de entrada especificado para todo el proceso y envía el mensaje WM_INPUTLANGCHANGE a la ventana Foco o Activo del subproceso actual. Normalmente, LoadKeyboardLayout activa un identificador de configuración regional de entrada solo para el subproceso actual.
a partir de Windows 8: Esta marca no se usa. LoadKeyboardLayout activa siempre un identificador de configuración regional de entrada para todo el sistema si el proceso actual posee la ventana con el foco del teclado. |
|
Esta marca no es compatible. Use la función UnloadKeyboardLayout en su lugar. |
Valor devuelto
Tipo: HKL de
Si la función se ejecuta correctamente, el valor devuelto es el identificador de configuración regional de entrada correspondiente al nombre especificado en pwszKLID. Si no hay ninguna configuración regional coincidente disponible, el valor devuelto es el idioma predeterminado del sistema.
Si se produce un error en la función, el valor devuelto es NULL. Esto puede ocurrir si la biblioteca de diseño se carga desde el directorio de la aplicación.
Para obtener información de error extendida, llame a GetLastError.
Observaciones
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 Editor de métodos de entrada (IME) o cualquier otra forma de entrada.
Una aplicación puede cargar normalmente el identificador de configuración regional de entrada predeterminado o IME para un idioma y puede hacerlo especificando solo una versión de cadena del identificador de idioma. Si una aplicación quiere cargar una configuración regional específica o un IME, debe leer el registro para determinar el identificador de configuración regional de entrada específico que se va a pasar a LoadKeyboardLayout. En este caso, una solicitud para activar el identificador de configuración regional de entrada predeterminado para una configuración regional activará la primera coincidente. Se debe activar un IME específico mediante un identificador de configuración regional de entrada explícito devuelto desde GetKeyboardLayout o LoadKeyboardLayout.
antes de Windows 8: Esta función solo afecta al diseño del proceso o subproceso actual.
a partir de Windows 8: Esta función afecta al diseño de todo el sistema.
Nota
El encabezado winuser.h define LoadKeyboardLayout como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winuser.h (incluya Windows.h) |
| biblioteca de |
User32.lib |
| DLL de |
User32.dll |
Consulte también
conceptual de
otros recursos
de referencia de