peekmessage函数

函数功能：该函数为一个消息检查线程消息队列，并将该消息放于指定的结构。  
   
          函数原型：bool   peekmessage； 

BOOL PeekMessage(          LPMSG lpMsg,
    HWND hWnd,
    UINT wMsgFilterMin,
    UINT wMsgFilterMax,
    UINT wRemoveMsg
);

  
          参数：  
   
          lpmsg：接收消息信息的msg结构指针。  
   
          hwnd：其消息被检查的窗口的句柄。  
   
          wmsgfiltermin：指定被检查的消息范围里的第一个消息。  
   
          wmsgfiltermax：指定被检查的消息范围里的最后一个消息。  
   
          wremovemsg：确定消息如何被处理。此参数可取下列值之一：  
   
          pm_noremove：peekmessage处理后，消息不从队列里除掉。  
   
          pm_remove：peekmessage处理后，消息从队列里除掉。  
   
          可将pm_noyield随意组合到pm_noremove或pm_remove。此标志使系统不释放等待调用程序空闲的线程。  
   
          缺省地，处理所有类型的消息。若只处理某些消息，指定一个或多个下列值：  
   
          pm_qs_input：windows   nt5.0和windows   98：处理鼠标和键盘消息。  
   
          pm_qs_paint：windows   nt   5.0和windows   98：处理画图消息。  
   
          pm_qs_postmessage：windows   nt   5.0和windows   98：处理所有被寄送的消息，包括计时器和热键。  
   
          pm_qs_sendmessage：windows   nt   5.0和windows   98：处理所有发送消息。  
   
          返回值：如果消息可得到，返回非零值；如果没有消息可得到，返回值是零。  
   
          备注：和函数getmessage不一样的是，函数peekmesssge在返回前不等待消息被放到队列里。  
   
          peekmesssge只得到那些与参数hwnd标识的窗口相联系的消息或被lschild确定为其子窗口相联系的消息，并且该消息要在由参数wmsgfitermin和wmsgfihermax确定的范围内。如果hwnd为null，则peekmessage接收属于当前调用线程的窗口的消息。如果hwnd为c1，peekmessage只返回hwnd值为null的消息，该消息由函数postthreadmessage寄送。如果wmsgfiltermin和wmsgfiltermax都为零，getmessage返回所有可得的消息。  
   
          常数wm_keyfirst和wmkeylast可作为过滤值取得所有键盘消息；常数wm_mousefirst和wm_mouselast可用来接收所有的鼠标消息。  
   
          peekmessage通常不从队列里清除wm_pant消息。该消息将保留在队列里直到处理完毕。但如果wm_paint消息有一个空更新区，peekmessage将从队列里清除wm_paint消息。  
   
          windows   ce：有一个null更新区的wm_paint消息不从队列里清除。  
   
          速查：windows   nt：3.1及以上版本；wihdows：95及以上版本：windows   ce：1.0及以上版本；头文件：winuser.h输入库：user32.lib：unicode：在windows   nt环境下以unicode和ansi方式实现。