功能说明
WinCE/Win32 :该函数从进程消息队列中检索一个消息,并将该消息(如果存在的话)赋值给指定的消息结构。跟GetMessage 不同之处在于:PeekMessage 不会等待消息,而是不间断地访问消息队列,不管消息队列的目前状态如何。
PeekMessage 在检索应用程序的消息队列时,如果其中有消息就将其放入lpMsg (如下所示的函数原型的声明中)所指的结构中,同时PeekMessage 函数不会等到有消息放入队列时才返回。同样,如果hWnd 为NULL ,则PeekMessage 检索对象为进程的消息队列;如果hWnd = -1 ,那么函数只检索消息队列中hWnd 参数为NULL 的PostThreadMessage 函数投递的消息;如果 wMsgFilterMin 和wMsgFilterMax 都是0,则PeekMessage 就检索所有有效消息;对一个消息在完成检索之后,可以显式地删除之(WM_PAINT 例外,因为WM_PAINT 需要合并处理,只有在合并处理之后才会被删除),也可以显式地保留之。
函数格式
BOOL PeekMessage (
LPMSG IpMsg , // 检索到的消息
HWND hWnd , // 窗口指向
UINT wMSGfilterMin ,// 消息范围的下界限参数
UINT wMsgFilterMax ,// 上界限参数
UINT wRemoveMsg // 消息在被检索之后要如何处理
);
参数说明
lpMsg ,【out 】
接收消息信息的MSG 结构指针,用于存放检索到的消息,不能为空指针。
hWnd ,【in 】
窗口指向,其消息要被检索。如果为空,则PeekMessage 的检索对象就变为进程消息队列了。
wMsgFilterMin ,【in 】
指定被检索的消息范围的下界限。
wMsgFilterMax ,【in 】
指定被检索的消息范围的上界限。如果wMsgFilterMin 跟wMsgFilterMax 都为零,则PeekMessage 将检索所有消息。
wRemoveMsg ,【in 】
确定消息被检索之后要如何处理。
此参数可取下列值之一:
PM_NOREMOVE :消息被PeekMessage 处理后,不要除掉;
PM_REMOVE :消息被PeekMessage 处理后,需要除掉;
PM_NOYIELD :跟PM_NOREMOVE 或PM_REMOVE 相结合使用,此标志防止系统释放任何正在等待被调用的线程;
默认设置下处理所有类型的消息,若要求只处理某些消息,则指定一个或多个下列值:
PM_QS_INPUT :Windows 98/Me, Windows 2000/XP ,处理鼠标和键盘消息。
PM_QS_PAINT :Windows 98/Me, Windows 2000/XP ,处理画图消息。
PM_QS_POSTMESSAGE :Windows 98/Me, Windows 2000/XP ,处理所有被投递的消息,包括timers 和 hotkeys 。
PM_QS_SENDMESSAGE :Windows 98/Me, Windows 2000/XP ,处理所有发送的消息。
返回值
如果可以检索到有效消息,则返回非零值;如果不能够检索到有效消息,则返回值是零。
备注
如果参数hWnd 不为零,则PeekMessage 只检索属于hWnd 窗体的消息,和被IsChild 确定为hWnd 之子窗口的消息,消息检索范围为wMsgFilterMin 跟wMsgFilterMax 所限定,如果二者都为零,则消息检索范围为所有消息;
如果参数hWnd 为NULL ,则PeekMessage 检索其所属进程的消息队列消息,消息的检索范围为参数wMsgFilterMin 跟wMsgFilterMax 所限定,如果这二者都为零,则消息检索范围为所有消息;
PeekMessage 随时可以检索到WM_QUIT 消息,即使设置了消息范围也不能阻止;
PeekMessage 只检索进程内的消息,不检索其它进程的消息;
和函数GetMessage 不一样的是,函数PeekMesssge 在检索消息队列消息时不等待消息,就是不管消息队列目前状态,都要返回检索结果;
PeekMessage 通常在处理WM_PAINT 消息后,不会删除之,除非WM_PAINT 所联系的区域为空值,或者WM_PAINT 消息被合并处理后,才会删除之;
常数WM_KEYFIRST 和WMKEYLAST 可作为过滤值取得所有键盘消息;常数WM_MOUSEFIRST 和WM_MOUSELAST 可用来接收所有的鼠标消息;
如果一个顶层窗口停止响应的消息超过几秒钟,系统认为窗口没有响应,就用一个叫做备用窗口替代之,该窗口具有相同的Z 序列,位置,大小和视觉属性。这使 用户可以移动,调整大小,甚至关闭该应用程序。然而,这些仅仅是动作,因为现有的应用实际上是没有回应。然而当应用程序正在调试,系统不会产生备用窗口。
适用
Windows NT :3.1 及以上版本;Wihdows :95 及以上版本:Windows CE :1.0 及以上版本;头文件:winuser.h 输入库:user32.lib :Unicode :在Windows NT 环境下以Unicode 和ANSI 方式实现。
应用举例
HWND hwnd = NULL ; BOOL fDone = FALSE ; MSG msg = {0};
// Begin the operation and continue until it is complete or until the user clicks
// the mouse or presses a key.
fDone = FALSE ;
while (!fDone) {
// application-defined function
fDone = DoLengthyOperation();
// Remove any messages that may be in the queue. If the queue contains
// any mouse or keyboard messages, end the operation.
while (PeekMessage(& msg, hwnd, 0, 0, PM_REMOVE )) {
switch (msg.message) {
case WM_LBUTTONDOWN :
case WM_RBUTTONDOWN :
case WM_KEYDOWN :
// Perform any required cleanup.
fDone = TRUE ;
}
}
}