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;

        }

    }

}