Win32消息处理API---PeekMessage

    技术2022-05-11  8

     

    03、PeekMessage

    功能说明

    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;

            }

        }

    }

     


    最新回复(0)