GetQueueStatus

Funkcja GetQueueStatus zwraca wartość flagi wskazujące typ wiadomości znaleźć wywołujący wątku wiadomości kolejki.

(DWORD GetQueueStatus UINT  flagi / / flags stan kolejki);
 

Parametry

flagi
Określa stan kolejki flagi podając typów wiadomości do sprawdzenia. Ten parametr może być kombinacją następujących wartości:
Wartość Znaczenie
QS_ALLEVENTS Dane wejściowe, WM_TIMER, WM_PAINT, WM_HOTKEY lub ogłoszoną wiadomość jest w kolejce.
QS_ALLINPUT Każda wiadomość jest w kolejce.
QS_ALLPOSTMESSAGE Ogłoszoną wiadomość (inne niż te wymienione tutaj) jest w kolejce.
QS_HOTKEY Wiadomość WM_HOTKEY jest w kolejce.
QS_INPUT Komunikat wejściowy jest w kolejce.
QS_KEY Wiadomość WM_KEYUP, WM_KEYDOWN, WM_SYSKEYUP lub WM_SYSKEYDOWN jest w kolejce.
QS_MOUSE WM_MOUSEMOVE wiadomości lub wiadomości przycisk myszy (WM_LBUTTONUP, WM_RBUTTONDOWN itd.).
QS_MOUSEBUTTON Wiadomości przycisk myszy (WM_LBUTTONUP, WM_RBUTTONDOWN itd.).
QS_MOUSEMOVE Wiadomość WM_MOUSEMOVE jest w kolejce.
QS_PAINT Wiadomość WM_PAINT jest w kolejce.
QS_POSTMESSAGE Ogłoszoną wiadomość (inne niż te wymienione tutaj) jest w kolejce.
QS_SENDMESSAGE Wiadomość wysyłana przez inny wątek lub aplikacji jest w kolejce.
QS_TIMER Komunikatu WM_TIMER jest w kolejce.

Zwraca wartości

Słowo wysokich numerach wartość zwracany wskazuje typy wiadomości aktualnie w kolejce. Word bity wskazuje typy wiadomości, które zostały dodane do kolejki i które są nadal w kolejce od czasu ostatniego wywołania funkcji GetQueueStatus, GetMessagelub PeekMessage.

Uwagi

Obecność flagi QS_ w wartości zwracanej nie gwarantuje, że kolejne wywołania funkcji GetMessage lub PeekMessage zwróci komunikat. GetMessage i PeekMessage wykonać niektóre wewnętrzne filtrowania, który może powodować wiadomości mają zostać przetworzone wewnętrznie. Z tego powodu należy rozważyć wartość zwracany z GetQueueStatus tylko wskazówkę co do tego, czy powinna zostać wywołana GetMessage lub PeekMessage.

Flagi QS_ALLPOSTMESSAGE i QS_POSTMESSAGE różnią się w, gdy są wyczyszczone. QS_POSTMESSAGE jest czyszczona podczas wywołania GetMessage lub PeekMessage, czy nie są filtrowania wiadomości. QS_ALLPOSTMESSAGE jest czyszczona podczas wywołania GetMessage lub PeekMessage bez filtrowania wiadomości (wMsgFilterMin i wMsgFilterMax są 0). To może być przydatne podczas wywołania wiele razy PeekMessage Aby uzyskać wiadomości w różnych zakresach.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Omówienie kolejek wiadomości i wiadomości, wiadomości i funkcje kolejek wiadomości, GetInputState, GetMessage, PeekMessage

Index