ActivateKeyboardLayout

As implementações de ActivateKeyboardLayout no Windows NT e Windows 95 são substancialmente diferentes. Para acomodar essas diferenças, esta página de referência apresenta pela primeira vez a implementação do Windows NT em sua totalidade, seguida pela versão Windows 95.

nbsp;Windows &NT
A função ActivateKeyboardLayout ativa um layout de teclado diferente e define o layout de teclado ativo para todo o sistema, em vez do thread de chamada.

(HKL ActivateKeyboardLayout HKL  hkl, / / identificador layout de tecladoUINTSinalizadores / / sinalizadores layout de teclado);
 

Parâmetros

hkl

Identificador para o layout de teclado para ser ativado. O layout deve ter sido carregado por um chamar anterior para a LoadKeyboardLayout função. Este parâmetro deve ser o identificador para um layout de teclado ou um dos seguintes valores.

Valor	Significado
HKL_NEXT	Seleciona o próximo layout na lista circular de layouts carregados mantidas pelo sistema.
HKL_PREV	Seleciona o layout anterior da lista circular de layouts carregados mantidas pelo sistema.

Sinalizadores

Especifica como o layout de teclado deve ser ativado. Este parâmetro pode ser uma dos seguinte valores.

Valor	Significado
KLF_REORDER	Se este bit for definido, lista circular do sistema de layouts de teclado carregado é reordenada. Se este bit não estiver definido, a lista é girada sem uma mudança de ordem. Por exemplo, se um usuário tivesse um layout inglês ativo, bem como ter francês, layouts de alemão e espanhol carregado (nesta ordem), em seguida, ativando o layout alemão com o KLF_REORDER conjunto de bits produziria a seguinte ordem: alemão, inglês, francês, espanhol. Ativando o layout alemão sem o KLF_REORDER conjunto de bits produziria a seguinte ordem: alemão, espanhol, inglês, francês. Se menos de três layouts de teclado são carregados, o valor desse sinalizador é irrelevante.
KLF_SETFORPROCESS	Windows NT 5.0 e posterior: Ativa o layout de teclado especificado para todo o processo e envia a mensagem WM_INPUTLANGCHANGE para Tudo segmentos no processo atual.
KLF_UNLOADPREVIOUS	O layout anteriormente ativo é descarregado.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o identificador de layout de teclado anterior. Caso contrário, é zero. Para informações de erro estendidas get, use o GetLastError função.

Observações

Diversos layouts de teclado podem ser carregados em qualquer momento, mas apenas uma é ativa por vez. Carregar vários layouts de teclado torna possível alternar rapidamente entre layouts de.

 Windows 95
A ActivateKeyboardLayout função define o idioma de entrada para o thread atual. Essa função aceita um identificador de layout de teclado que identifica uma localidade, bem como o layout físico do teclado.

(HKL ActivateKeyboardLayout HKL  hkl, / / identificador layout de tecladoUINTSinalizadores / / sinalizadores layout de teclado);
 

Parâmetros

hkl

Identificador para um layout de teclado ou um zero-estendido identificador de idioma. Este parâmetro pode ser qualquer identificador de layout de teclado válido obtido usando a função LoadKeyboardLayout ou GetKeyboardLayoutList ou um dos seguintes valores.

Valor	Significado
HKL_NEXT	Seleciona o próximo layout na lista de layouts de teclado mantida pelo sistema.
HKL_PREV	Seleciona o layout anterior na lista de layout de teclado mantida pelo sistema.

Sinalizadores

Especifica os sinalizadores de layout de teclado. O valor deste parâmetro pode ser:

Valor

Significado

KLF_REORDER

Reordena a lista de layouts de teclado, movendo o identificador de layout de teclado fornecido para Cabeçalholho da lista. Se esse valor não for especificado, a lista é girada sem uma mudança de ordem. Por exemplo, se um usuário tivesse um layout inglês ativo, bem como ter francês, layouts de alemão e espanhol carregado (nesta ordem), em seguida, ativando o layout alemão com o KLF_REORDER conjunto de bits produziria a seguinte ordem: alemão, inglês, francês, espanhol. Ativando o layout alemão sem a KLF_REORDER valor conjunto produziria a seguinte ordem: alemão, espanhol, inglês, francês.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o identificador de layout de teclado anterior. Caso contrário, é zero. Para informações de erro estendidas get, use o GetLastError função.

Observações

Diversos layouts de teclado podem ser carregados em qualquer momento, mas apenas uma é ativa por vez. Carregar vários layouts de teclado torna possível alternar rapidamente entre layouts de.

Um aplicativo pode criar um identificador de layout de teclado válido, definindo a palavra alta para zero e a palavra baixa a um identificador de localidade. Usando essas alterações de alças de layout de teclado do idioma de entrada sem afetar o layout físico.

Quando vários editores de método de entrada (IMEs) são permitidos para cada localidade, passando um identificador de layout de teclado em que a palavra (o identificador de dispositivo) é zero ativa o IME primeiro na lista de "pertença" a localidade.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de entrada de teclado, funções de entrada de teclado, LoadKeyboardLayout, GetKeyboardLayoutName, UnloadKeyboardLayout

Index