MapVirtualKeyEx

A função MapVirtualKeyEx converte (mapas) virtual-chave código em um valor de código ou caractere digitalizar, ou converte um codificar digitalizar em um virtual-código de chave. A função converte os códigos usando o idioma de entrada e o layout de teclado físico identificado pelo identificador de layout de teclado fornecido.

 (UINT MapVirtualKeyEx UINT  uCode, / / chave virtual código código ou varreduraUINTuMapType, / / tradução para executarHKLdwhkl / / identificador layout de teclado);
 

Parâmetros

uCode
Especifica o código de verificação ou código de chave virtual para uma chave. Como esse valor é interpretado depende do valor do parâmetro uMapType.
uMapType
Especifica a conversão para executar. O valor deste parâmetro depende o valor da uCode parâmetro:
Valor Significado
0 uCode é um virtual-código de chave e é convertido em um codificar digitalizar. Se for uma virtual-código de chave que não faz distinção entre chaves left - and right - hand, a codificar digitalizar esquerdo será retornada. Se não houver nenhuma conversão, a função retorna 0.
1 uCode é um codificar digitalizar e é convertido em um virtual-código de chave que não faz distinção entre left - and right - hand chaves. Se não houver nenhuma conversão, a função retorna 0.
2 uCode é um virtual-código de chave e é convertido em um valor caractere unshifted na palavra de ordem inferior do valor de retorno. Teclas mortas (diacríticos) são indicadas por configuração o parte superior bit of o valor de retorno. Se não houver nenhuma conversão, a função retorna 0.
3 uCode é um codificar digitalizar e é convertido em um virtual-código de chave que distingue entre left - and right - hand chaves. Se não houver nenhuma conversão, a função retorna 0.

dwhkl
Identificador para o layout de teclado a ser usado para traduzir o código fornecido. Este parâmetro pode ser qualquer identificador de layout de teclado anteriormente retornado por LoadKeyboardLayout função.

Retornar valores

O valor de retorno é um código de verificação, um virtual-código de chave ou um valor de caracteres, dependendo do valor da uCode e uMapType. Se não há tradução, o valor de retorno é zero.

Observações

Um aplicativo pode usar MapVirtualKeyEx para converter códigos de varredura para as constantes do código de chave virtual VK_SHIFT, VK_CONTROL e VK_MENU e vice-versa. Essas traduções não distinguem entre as instâncias de esquerda e direita da tecla shift, ctrl ou alt chaves. Um aplicativo pode obter o código de verificação correspondente a instância de esquerda ou direita de uma destas chaves chamando MapVirtualKeyEx com uCode definido como uma das seguintes constantes código de chave virtual.

VK_LSHIFT VK_RSHIFT
VK_LCONTROL VK_RCONTROL
VK_LMENU VK_RMENU

Essas constantes distinção entre esquerda e direita estão disponíveis para um aplicativo somente através de GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyState, MapVirtualKeye MapVirtualKeyEx funções. Para lista completa tabela de códigos de tecla virtuais, consulte Virtual-chave códigos.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 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.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de entrada de teclado, funções de entrada de teclado, GetAsyncKeyState, GetKeyboardState, GetKeyState, LoadKeyboardLayout, MapVirtualKey, SetKeyboardState

Index