TranslateMessage

9/9/2008

Essa função converte virtual - chave mensagens em mensagens caractere. As mensagens caractere são postadas para fila de mensagens do segmento chamado, seja ler o próximo tempo chama o segmento de GetMessage Ou PeekMessage função.

Syntax

BOOL TranslateMessage(
  const MSG* lpMsg 
); 

Parameters

• lpMsg
  [no] Ponteiro para um MSG estrutura que contém informações mensagem recuperados do fila de mensagens do segmento de chamado usando o GetMessage Ou PeekMessage função.

Return Value

Nonzero indica que a mensagem é convertida, ou seja, uma mensagem caractere está lançada para fila de mensagens do segmento. Se a mensagem for WM_KEYDOWN ou WM_SYSKEYDOWN, o valor de retorno é diferente de zero, regardless of a conversão. Zero indica que a mensagem não é traduzida, ou seja, uma mensagem caractere não está lançada para fila de mensagens do segmento.

Remarks

O TranslateMessage função não modifica a mensagem apontada pelo lpMsg parâmetro.

WM_KEYDOWN e WM_KEYUP gerar combinações um WM_CHAR mensagem. WM_SYSKEYDOWN e WM_SYSKEYUP gerar combinações um WM_SYSCHAR Ou WM_SYSDEADCHAR mensagem.

TranslateMessage produz mensagens WM_CHAR somente para as chaves que são mapeadas para caracteres ASCII pelo driver de teclado. Windows Embedded CE suporte não códigos digitalizar ou sinalizadores chave estendida, portanto, ele não suporte os valores 16 a 24 a lKeyData (parâmetrolParam) das WM_CHAR mensagem gerada pelo TranslateMessage função.

TranslateMessage Só pode ser usado para converter as mensagens recebidas de chamadas para GetMessage Ou PeekMessage.

Se aplicativos processo virtual-chave mensagens para algum outro propósito, eles não devem chamar TranslateMessage. PARA instância, um aplicativo não deve chamar TranslateMessage Se a TranslateAccelerator função retorna um diferente de zero valor.

Requirements

See Also

Reference

Message Queue Functions
GetMessage
PeekMessage
TranslateAccelerator
WM_CHAR
WM_KEYDOWN
WM_KEYUP
WM_SYSCHAR
WM_SYSDEADCHAR
WM_SYSKEYDOWN
WM_SYSKEYUP