GetQueueStatus

Функция GetQueueStatus Возвращает флаги, указывающие тип сообщений в очереди сообщений вызывающего потока.

() DWORD GetQueueStatus UINT  флаги / / флаги состояния очереди);
 

Параметры

флаги
Указывает флаги состояния очереди, давая типы сообщений для проверки. Этот параметр может быть комбинацией следующих значений:
Значение Значение
QS_ALLEVENTS Вход, WM_TIMER, WM_PAINT, WM_HOTKEY или написал сообщение находится в очереди.
QS_ALLINPUT Любое сообщение находится в очереди.
QS_ALLPOSTMESSAGE Написал сообщение (за исключением тех, которые перечислены здесь) находится в очереди.
QS_HOTKEY WM_HOTKEY сообщение находится в очереди.
QS_INPUT Входное сообщение находится в очереди.
QS_KEY WM_KEYUP, WM_KEYDOWN, WM_SYSKEYUP или WM_SYSKEYDOWN сообщение находится в очереди.
QS_MOUSE WM_MOUSEMOVE сообщение или сообщение кнопки мыши (WM_LBUTTONUP, WM_RBUTTONDOWN и т. д.).
QS_MOUSEBUTTON Кнопки мыши сообщение (WM_LBUTTONUP, WM_RBUTTONDOWN и т. д.).
QS_MOUSEMOVE WM_MOUSEMOVE сообщение находится в очереди.
QS_PAINT WM_PAINT сообщение находится в очереди.
QS_POSTMESSAGE Написал сообщение (за исключением тех, которые перечислены здесь) находится в очереди.
QS_SENDMESSAGE Сообщение, отправленное другого потока или приложение находится в очереди.
QS_TIMER WM_TIMER сообщение находится в очереди.

Возвращаемые значения

Старшее слово возвращаемого значения указывает типы сообщений в настоящее время в очереди. Младшее слово указывает типы сообщений, которые были добавлены в очередь и которые все еще находятся в очереди с момента последнего вызова функции GetQueueStatus, GetMessageили PeekMessage.

Примечания

Присутствие QS_ флага в возвращаемое значение не гарантирует, что следующий вызов функции GetMessage или PeekMessage будет возвращать сообщение. GetMessage и PeekMessage выполняют некоторые внутренние фильтрации, которые могут привести к внутренне обработку сообщений. По этой причине значение, возвращаемое методом GetQueueStatus следует рассматривать только подсказку, чтобы ли должен называться GetMessage или PeekMessage.

Флаги QS_ALLPOSTMESSAGE и QS_POSTMESSAGE отличаются в когда они очищаются. QS_POSTMESSAGE очищается при вызове GetMessage или PeekMessageли фильтрация сообщений. QS_ALLPOSTMESSAGE очищается при вызове GetMessage или PeekMessage без фильтрации сообщений (wMsgFilterMin и wMsgFilterMax — 0). Это может быть полезным при вызове PeekMessage несколько раз для получения сообщений в различных диапазонах.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Использование user32.lib.

Родственные слова

Обзор очереди сообщений и сообщений, сообщения и функции очереди сообщений, GetInputState, GetMessage, PeekMessage

Index