函数功能:该函数为一个消息检查线程消息队列,并将该消息放于指定的结构。
函数原型:bool peekmessage;
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方式实现。