GetQueueStatus

La funzione GetQueueStatus restituisce bandiere che indicano il tipo di messaggi nella coda di messaggi del thread chiamante.

(DWORD GetQueueStatus UINT  bandiere / / lo stato coda flags);
 

Parametri

bandiere
Specifica lo stato di coda flag dando tipi di messaggi per verificare. Questo parametro può essere una combinazione dei seguenti valori:
Valore Significato
QS_ALLEVENTS Un input, WM_TIMER, WM_PAINT, WM_HOTKEY o messaggio inviato è nella coda.
QS_ALLINPUT Qualsiasi messaggio è nella coda.
QS_ALLPOSTMESSAGE Un messaggio inviato (diversi da quelli elencati qui) è nella coda.
QS_HOTKEY È un messaggio WM_HOTKEY in coda.
QS_INPUT Un messaggio di input sia presente nella coda.
QS_KEY È un messaggio WM_KEYUP, WM_KEYDOWN, WM_SYSKEYDOWN o WM_SYSKEYUP nella coda.
QS_MOUSE Un messaggio WM_MOUSEMOVE o del pulsante del mouse (WM_LBUTTONUP, WM_RBUTTONDOWN e così via).
QS_MOUSEBUTTON Un messaggio del pulsante del mouse (WM_LBUTTONUP, WM_RBUTTONDOWN e così via).
QS_MOUSEMOVE È un messaggio WM_MOUSEMOVE nella coda.
QS_PAINT Un messaggio WM_PAINT è nella coda.
QS_POSTMESSAGE Un messaggio inviato (diversi da quelli elencati qui) è nella coda.
QS_SENDMESSAGE Un messaggio inviato da un altro thread o applicazione è nella coda.
QS_TIMER È un messaggio WM_TIMER in coda.

Valori restituiti

La parola di ordine superiore del valore restituito indica i tipi di messaggi attualmente nella coda. La parola di ordine inferiore indica i tipi di messaggi che sono stati aggiunti alla coda e che sono ancora in coda dall'ultima chiamata alla funzione GetQueueStatus, GetMessageo PeekMessage.

Osservazioni

La presenza di una bandiera QS_ nel valore restituito non garantisce che una chiamata successiva alla funzione GetMessage o PeekMessage restituirà un messaggio. GetMessage e PeekMessage di eseguire alcuni filtri interni che possono causare il messaggio da elaborare internamente. Per questo motivo, il valore restituito da GetQueueStatus dovrebbe essere considerato solo un suggerimento da se deve essere chiamato GetMessage o PeekMessage.

I flag QS_ALLPOSTMESSAGE e QS_POSTMESSAGE si differenziano quando essi vengono cancellati. QS_POSTMESSAGE viene cancellato quando si chiama GetMessage o PeekMessage, o meno si filtrano i messaggi. QS_ALLPOSTMESSAGE viene cancellato quando si chiama GetMessage o PeekMessage senza filtraggio dei messaggi (wMsgFilterMin e wMsgFilterMax sono 0). Ciò può essere utile quando si chiama PeekMessage più volte di ricevere messaggi con diverse gamme.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
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, GetInputState, GetMessage, PeekMessage

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

Index