TranslateMessage

La funzione TranslateMessage converte i messaggi chiave virtuale in messaggi di carattere. Il personaggio di messaggi sono inviati alla coda di messaggi del thread chiamante, da leggersi la prossima volta il thread chiama il GetMessage o la funzione PeekMessage.

(BOOL TranslateMessage MSG CONST  * msg / / indirizzo della struttura con messaggio);
 

Parametri

msg
Puntatore a una struttura MSG che contiene le informazioni del messaggio recuperato dalla coda di messaggi del thread chiamante utilizzando la funzione GetMessage o PeekMessage.

Valori restituiti

Se il messaggio viene tradotto (che , un messaggio di carattere inviato alla coda di messaggi del thread), il valore restituito diverso da zero.

Se il messaggio WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP o WM_SYSKEYUP, il valore restituito diverso da zero, indipendentemente la traduzione.

Se il messaggio non tradotto (che , un messaggio di carattere non inviato alla coda di messaggi del thread), il valore restituito pari a zero.

Osservazioni

La funzione TranslateMessage non modifica il messaggio a cui puntato il parametro msg.

WM_KEYDOWN e WM_KEYUP combinazioni producono un messaggio WM_CHAR o WM_DEADCHAR . WM_SYSKEYDOWN e WM_SYSKEYUP combinazioni producono un messaggio WM_SYSCHAR o WM_SYSDEADCHAR.

TranslateMessage produce messaggi WM_CHAR solo per i tasti che vengono mappati ai caratteri ASCII dal driver di tastiera.

Se le applicazioni di elaborare i messaggi chiave virtuale per qualche altro motivo, non si deve chiamare TranslateMessage. Per esempio, un'applicazione non deve chiamare TranslateMessage se la funzione TranslateAccelerator restituisce un valore diverso da zero.

Windows CE: Windows CE non supporta codici di scansione o estese bandiere chiave, quindi non supporta i valori 16-24 nel parametro lKeyData (lParam) del messaggio WM_CHAR generato dalla funzione TranslateMessage.

TranslateMessage pu essere utilizzato solo per tradurre i messaggi ricevuti da chiamate a GetMessage o PeekMessage.

Descrizione

nbsp;Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Messaggi e panoramica delle code di messaggi, messaggio e funzioni di coda dei messaggi, GetMessage, PeekMessage, TranslateAccelerator, WM_CHAR, WM_DEADCHAR, WM_KEYDOWN, WM_KEYUP, WM_SYSCHAR, WM_SYSDEADCHAR, WM_SYSKEYDOWN, WM_SYSKEYUP

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index