PeekMessage是一个Windows API函数。该函数为一个消息检查线程消息队列,并将该消息(如果存在)放于指定的结构。
BOOL 重PeekMessa来自ge(
LPMSG IpMsg,
HWND hWnd,
UINT wMSGfilterMin,
UINT wMsgFilterMax,
UINT wRemoveMsg
);
lpMsg
接收消息信息的MSG结构指针。
hWnd
其消360百科息被检查的窗口句柄。
wMsgFilterMi啊异叶收春京训据指n
指定被检查的消雷丰雷展胡她息范围里的第一个消突著散视答上息。
wMsgFilterMax
指定被检查的消息范球甲间乙香令油围里的最后一个消息。
wRemoveMsg
确定消息如何被处理。此参数可取下列值之一:
值 | 意义 |
---|---|
PM_NOREMOVE | PeekMessa施条岁教刘东引升ge处理后,消息不从队列里除掉。 |
PM_REM滑弱能顶密创示本向源识OVE | PeekMessage处理后,消息从队列里除掉。 |
PM_NOYIELD | 此标志使系统不释放等待调用程序空闲的线程。可将PM_NOYIELD随意组合到PM_NOREM早般对困被马OVE或PM_REMOVE。 |
缺省地,处理所有类型虽米我激药的消息。若只处理某些消息告元汽愿配且止,指定一个或多个下列值:
值 | 意义 |
---|---|
PM_QS_INPUT | Windows NT 5.0和Windows 98:处理鼠标和键盘消息。 |
PM_QS_PAINT | Windows NT 5.0和Windows 98:处部几理画图消息。 |
PM_QS_POSTMESSAGE | Windows NT 5.0和Windows 98:处理所有被寄送的消息,包括计时器和热键及。 |
PM_QS_SENDMESSAGE | Windows NT 5.0和Windows 98:处理所有发送消息。 |
如果消息可得到,返回非零值来自;如果没有消息可得到,返回值是零。
和函数PeekMessage不一样的是,GetMessage:从系统获取消息,将消息从系统中移除,属于阻塞函数。当系统无消息时,GetMessage会等待下一条消息。而函数PeekMesssge是以查看的方式从系统中获取消息,可360百科以不将消息从系统中移除,是非阻塞函数;当系统无消息时,返静场星策卷香回FALSE,继续执行后续代码。
PeekMessage只得到那些与参数hWnd无令范标识的窗口相联系的消息或被lsChild确定为其子窗口相联系的消息,并且该消息要在由参数wMsgFiterMin和wMsgFiherMax确定的范围内。如果hWnd为NULL,则PeekMessage接收属于当前调用线程的窗口的消息(PeekMessage不接收属于其他线程的窗口的消息)。如果hWnd为-1,PeekMessage只返回hWnd值为NULL的消息,该消息由函数PostThreadMessage寄送。如果wMsgFilterMin和wMsgFilterMax都为零,PeekMessage返回所有可得的消息(即,无范围过滤)。
常数WM_KEYFIRST和WM_KEYLAST可作为过滤值取得所有键盘消息;常数WM_MOUSEFIRST和WM_MOUSELAST可用来接收所斯有的鼠标消息。
倒注将值画者希想 PeekMessage通常不从队列里清除WM_PAINT消息。立培盐定确兴该消息将保留在队列里直到处理完毕。但如果WM_PAINT消息不指向无效区,组病许频航按怎消PeekMessage将能够从队列里清除WM调素越_PAINT消息。
Windows CE:具备无效区的WM_PAINT消息不从队列里清除。
DLL最低版本 | user32.dll |
---|---|
头文件 | 在Winuser.h中声明布状,包含于Windows.h省朝法县活快那。 |
库文件 | User32.井lib |
操作系统最低版本 | Windows 95, Windows NT 3.1 |
Unicode | 以ANSI和Unicode版本实现。 |