Win32消息处理API---PeekMessage

03、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;

}

}

}

本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/mengde666/archive/2009/04/03/4045644.aspx

本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/mengde666/archive/2009/04/03/4045644.aspx