PeekMessage

PeekMessage funkcia kontroly front hlásení vlákno pre správu a umiestni hlásenia (ak nejaká existuje) uvedené štruktúry.

BOOL PeekMessage ( LPMSG  lpMsg; / / smerník na štruktúru správyHWNDhWnd; / / spracovať do oknaUINTwMsgFilterMin; / / prvýkrát správy.UINTwMsgFilterMax; / / poslednej správy.UINTwRemoveMsg / / odstránenie flags);
 

Parametre

lpMsg
Smerník na MSG štruktúru, ktorá prijíma informácie o správe.
hWnd
Spracovať do okna, ktorých správy majú byť preskúmané.
wMsgFilterMin
Určuje hodnotu prvá správa v rozsahu správy analyzovaným.
wMsgFilterMax
Určuje hodnotu poslednú správu v rozsahu správy analyzovaným.
wRemoveMsg
Určuje spôsob spracovania správ. Tento parameter môže byť jedna z nasledovných hodnôt:
Hodnota Význam
PM_NOREMOVE Správy sa neodstránia z frontu po spracovaní v PeekMessage.
PM_REMOVE Správy sa odstránia z frontu po spracovaní v PeekMessage.

Voliteľne môžete skombinovať hodnotu PM_NOYIELD s PM_NOREMOVE alebo PM_REMOVE. Táto vlajka zabráni uvoľnenie vlákno, ktorá čaká na volajúci ísť nečinnosti systému (pozri WaitForInputIdle).

Podľa predvoleného nastavenia sú spracovávané všetky typy správ. Chcete zadať len určité správy spracovať, určiť jedného alebo viacerých z nasledujúcich hodnôt:
Hodnota Význam
PM_QS_INPUT Windows NT 5.0 a systém Windows 98: Procesu myš a klávesnicu správy.
PM_QS_PAINT Windows NT 5.0 a systém Windows 98: Proces maľovať správy.
PM_QS_POSTMESSAGE Windows NT 5.0 a systém Windows 98: Spracovať všetky publikované správy vrátane časovače a klávesové skratky.
PM_QS_SENDMESSAGE Windows NT 5.0 a systém Windows 98: Spracovávať všetky odoslané správy.

Note:

Ak správa je k dispozícii, vrátená hodnota je nenulové.

Ak sú k dispozícii žiadne správy, vrátená hodnota je nula.

Poznámky

Na rozdiel od GetMessage funkciu PeekMessage funkcie nebude čakať na sprßvou, ktorß sa do frontu pred návratom.

PeekMessage načíta len správy súvisiace s okienkom identifikovaný parametrom hWnd alebo ktorýkoľvek z jeho deti sú špecifikované funkcie IsChild a rozsahu správy hodnotám vydaným parametre wMsgFilterMin a wMsgFilterMax . Ak hWnd hodnotu NULL, PeekMessage načíta správy pre každého okna, ktoré patrí k aktuálne vlákno volaní. (PeekMessage načítať správy pre windows, ktoré patria k ostatným vláknam.) Ak hWnd je –1, PeekMessage vracia iba správy s hWnd hodnotu NULL, ako zaslal funkciu PostThreadMessage . Ak sú obe nulové, PeekMessage wMsgFilterMin a wMsgFilterMax vráti všetky dostupné správy (t. j. žiadne rozsah filtrovania sa vykonáva).

WM_KEYFIRST a WM_KEYLAST konštanty je možné použiť ako filter hodnoty na načítanie všetkých správ klávesnici; WM_MOUSEFIRST a WM_MOUSELAST konštanty je možné použiť na načítanie všetkých správ myši.

PeekMessage funkcie bežne neodstráni hlásenia WM_PAINT z frontu. Hlásenia WM_PAINT zostať vo fronte až do ich spracovania. Avšak ak hlásenie WM_PAINT má hodnotu null aktualizácia regiónu, PeekMessage ho odstrániť z frontu.

Windows CE: Hlásenia WM_PAINT reťazcom neplatné aktualizácia sa neodstránia z frontu.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v súbore winuser.h.
Importovať knižnica:Použiť user32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia v systéme Windows NT.

Pozri tiež

Správy a správy fronty prehľad, správy a správy vo fronte funkcie, GetMessage, IsChild, MSG, WaitForInputIdle, WaitMessage

Index