Função GetKeyboardLayoutList (winuser.h)
Recupera as identificações de localidade de entrada (chamadas antes de identificadores de layout de teclado) correspondentes ao conjunto atual de localidades de entrada no sistema. A função copia os identificadores do buffer especificado.
Sintaxe
int GetKeyboardLayoutList(
[in] int nBuff,
[out] HKL *lpList
);
Parâmetros
[in] nBuff
Tipo: int
O número máximo de identificadores que o buffer pode conter.
[out] lpList
Tipo: HKL*
Um ponteiro para o buffer que recebe a matriz de identificadores de localidade de entrada.
Valor retornado
Tipo: int
Se a função for bem-sucedida, o valor retornado será o número de identificadores de localidade de entrada copiados para o buffer ou, se nBuff for zero, o valor retornado será o tamanho, em elementos de matriz, do buffer necessário para receber todos os identificadores de localidade de entrada atuais.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
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 IME (Editor de Método de Entrada) ou qualquer outra forma de entrada.
A partir do 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
| 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 |
Confira também
Conceitual
Referência