TranslateMessage

A TranslateMessage função converte virtual-chave mensagens em mensagens caractere. O caractere mensagens são postadas para fila de mensagens do segmento chamado, deve ler-se o próximo tempo o segmento chamadas GetMessage ou PeekMessage função.

(BOOL TranslateMessage MSG CONST  * lpMsg / / endereço da estrutura com mensagem);
 

Parâmetros

lpMsg
Ponteiro para um MSG estrutura que contém informações de mensagem recuperada da fila de mensagens do segmento de chamado usando o GetMessage ou PeekMessage função.

Retornar valores

Se a mensagem é traduzida (isto é, uma mensagem caractere é postada a fila de mensagem do thread), o valor de retorno é diferente de zero.

Se a mensagem WM_KEYDOWN, WM_KEYUP, WM_SYSKEYDOWNou WM_SYSKEYUP, o valor de retorno é diferente de zero, independentemente da tradução.

Se a mensagem não estiver traduzida (ou seja, uma mensagem caractere é postada não a fila de mensagem do thread), o valor de retorno é zero.

Observações

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

WM_KEYDOWN e WM_KEYUP combinações produzem uma mensagem WM_CHAR ou WM_DEADCHAR . Combinações de WM_SYSKEYUP e WM_SYSKEYDOWN produzem uma mensagem de WM_SYSCHAR ou WM_SYSDEADCHAR.

TranslateMessage produz mensagens WM_CHAR somente para chaves que são mapeadas para caracteres ASCII pelo driver de teclado.

Se aplicativos processam virtual-chave mensagens para algum outro propósito, eles não devem chamar TranslateMessage. Por exemplo, um aplicativo não deve chamar TranslateMessage se o TranslateAccelerator função retorna um valor diferente de zero.

Windows CE: Windows CE não oferece suporte códigos de varredura ou sinalizadores de chaves estendidas, portanto, ele não oferece suporte os valores 16-24 na lKeyData parâmetro (lParam) da mensagem WM_CHAR gerado pela função TranslateMessage.

TranslateMessage só pode ser usado para traduzir mensagens recebidas de chamadas para o GetMessage ou PeekMessage.

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.

Ver também

Visão geral de filas de mensagens e mensagens, mensagens e funções de fila de mensagem, GetMessage, PeekMessage, TranslateAccelerator, WM_CHAR, WM_SYSDEADCHAR, WM_SYSKEYDOWN, WM_KEYUP, WM_SYSCHAR, WM_DEADCHAR, WM_KEYDOWN, WM_SYSKEYUP

Index