Win32消息处理API---PeekMessage

PeekMessage

功能说明



WinCE/Win32
：该函数从进程消息队列中检索一个消息，并将该消息（如果存在的话）赋值给指定的消息结构。跟GetMessage
不同之处在于：PeekMessage
不会等待消息，而是不间断地访问消息队列，不管消息队列的目前状态如何。

PeekMessage
在检索应用程序的消息队列时，如果其中有消息就将其放入lpMsg
（如下所示的函数原型的声明中）所指的结构中，同时PeekMessage
函数不会等到有消息放入队列时才返回。同样，如果hWnd
为NULL
，则PeekMessage
检索对象为进程的消息队列；如果hWnd = -1
，那么函数只检索消息队列中hWnd
参数为NULL
的PostThreadMessage
函数投递的消息；如果 wMsgFilterMin
和wMsgFilterMax
都是０，则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
;

       
}

   
}

}

 
区别
:

    1.GetMessage将等到有合适的消息时才返回,而PeekMessage只是撇一下消息队列。

    2.GetMessage会将消息从队列中删除,而PeekMessage可以设置最后一个参数wRemoveMsg来决定是否将消息保留在队列中。



      在Windows的内部，GetMessage和PeekMessage执行着
相同的代码。而两者最大的不同之处则体现在没有任何消息返回到应用程序的情况下。在此种情况下，PeekMessage会返回一个空值到应用程
序，GetMessage会在此时让应用程序休眠。