PeekMessage

Funcţia PeekMessage verifică thread un mesaj coada de aşteptare pentru un mesaj şi locuri mesajul (dacă există) în structura specificat.

(BOOL PeekMessage LPMSG  lpMsg, / / indicatorul structura pentru mesajHWNDhWnd, / / ocupa fereastraUINTwMsgFilterMin, / / primul mesajUINTwMsgFilterMax, / / ultimul mesajUINTwRemoveMsg / / eliminarea steaguri);
 

Parametrii

lpMsg

Indicator spre o structură MSG care primeşte informaţii mesaj.

hWnd

Ocupa în fereastra ale căror mesaje vor fi examinate.

wMsgFilterMin

Specifică valoarea primul mesaj în zona de mesaje de analizat.

wMsgFilterMax

Specifică valoarea ultimul mesaj în zona de mesaje de analizat.

wRemoveMsg

Specifică modul în care mesajele sunt manipulate. Acest parametru poate fi una dintre următoarele valori:

Valoarea	Sensul
PM_NOREMOVE	Mesajele nu sunt eliminate din coada de aşteptare după prelucrare de PeekMessage.
PM_REMOVE	Mesajele sunt eliminate din coada de aşteptare după prelucrare de PeekMessage.

Opţional puteţi combina valoarea PM_NOYIELD cu PM_NOREMOVE sau PM_REMOVE. Acest flag împiedică eliberarea orice subiect care este în aşteptare pentru persoana care a telefonat merge idle a sistemului (a se vedea WaitForInputIdle).

În mod implicit, toate tipurile de mesaje sunt prelucrate. Pentru a preciza că numai anumite mesaje ar trebui să fie prelucrate, specificaţi unul sau mai multe dintre următoarele valori:

Valoarea	Sensul
PM_QS_INPUT	Windows NT 5.0 şi Windows 98: Procesul de mesaje mouse ?i tastatură.
PM_QS_PAINT	Windows NT 5.0 şi Windows 98: Procesul de vopsea mesaje.
PM_QS_POSTMESSAGE	Windows NT 5.0 şi Windows 98: Procesul toate postat mesaje, inclusiv cronometre oi hotkeys.
PM_QS_SENDMESSAGE	Windows NT 5.0 şi Windows 98: Procesul toate trimis mesaje.

Valorile întroarse

Dacă un mesaj este disponibil, valoarea returnată este nenul.

În cazul în care mesajele nu sunt disponibile, valoarea returnată este zero.

Observaţii

Spre deosebire de funcţia GetMessage , funcţia PeekMessage nu aşteptaţi un mesaj pentru a fi plasate în coada de aşteptare înainte de a reveni.

PeekMessage preia numai mesajele asociate cu fereastra identificate de parametrul hWnd sau la oricare dintre copii sa ca specificată de funcţia IsChild , şi în intervalul de valori mesajul dat de parametrii de wMsgFilterMin şi wMsgFilterMax . Dacă hWnd este NULL, PeekMessage preia mesajele pentru orice fereastră care aparţine firul de execu?ie curent face apel. (PeekMessage nu prelua mesajele pentru windows care aparţin alte fire.) Dacă hWnd este –1, PeekMessage întoarce numai mesaje cu o valoare hWnd NULL, aşa cum Postat de funcţia PostThreadMessage . Dacă wMsgFilterMin şi wMsgFilterMax sunt ambele zero, PeekMessage întoarce toate mesajele disponibile (care este, nu gama de filtrare se efectuează).

Constantele de WM_KEYFIRST şi WM_KEYLAST poate fi folosit ca filtru valorile pentru a prelua toate mesajele de tastatură; constantele de WM_MOUSEFIRST şi WM_MOUSELAST pot fi utilizate pentru a prelua toate mesajele de mouse-ul.

Funcţia PeekMessage în mod normal nu elimina WM_PAINT mesajele din coada de aşteptare. WM_PAINT mesajele rămân în coada de aşteptare până când sunt prelucrate. Cu toate acestea, dacă un mesaj WM_PAINT are o regiune null update, PeekMessage elimina din coada de aşteptare.

Windows CE: WM_PAINT mesaje cu o actualizare null regiune nu sunt eliminate din coada de aşteptare.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.
Unicode:Pus în aplicare ca Unicode şi ANSI versiuni Windows NT.

A se vedea, de asemenea

Mesajele şi mesaj cozile de prezentare, mesaj şi mesaj coada de funcţii, GetMessage, IsChild, MSG, WaitForInputIdle, WaitMessage

Index