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

Confira também

Conceitual

GetKeyboardLayout

Entrada por teclado

Referência