MapVirtualKey

A função MapVirtualKey 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.

(UINT MapVirtualKey UINT  uCode, / / chave virtual código código ou varreduraUINTuMapType / / tradução para executar);
 

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 baixa-palavra ordem da 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.

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 MapVirtualKey para traduzir 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 MapVirtualKey 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 do GetKeyboardState, SetKeyboardState, GetAsyncKeyState GetKeyStatee MapVirtualKey funções.

Windows CE: Windows CE suporta somente um valor de 2 para o parâmetro de uMapType – mapeamento de teclas virtuais para caracteres unshifted.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
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, SetKeyboardState

Index