windows消息分流器

男娘i 2022-08-06 07:26 157阅读 0赞

对于熟悉Win API编程的同志们来说，windowsx.h这个头文件应该不会太陌生吧，这次要讲的内容就来自这个windowsx.h头文件。　　  
经常能在msdn上查到这样一些函数，明明是个函数，而且模样长得和一般的api函数也一样一样的，可却叫做macro，为什么呢？留意一下函数使用的requirement，你会发现，它的声明正是在windowsx.h这个头文件里。Windowsx.h包含了这样一些内容：  
宏API，窗口消息分流器，控件API；  
所有的这些宏定义，可以使你的程序更加安全，简洁，结构更清晰，大大提高程序的可读性；其中窗口消息分流器（message cracker）是我们今天要讨论的话题，它可以使我们的API程序变得更简洁。下面就进入我们的主题：（有关windowsx.h的更多内容，可以参考 MS Knowledge Base Article \#83456.）  
消息分流器是Windows提供的一组宏定义，它的两个最大的作用，用MS的话来说，就是：  
● 安全的数据类型，因为消息分流器完成了大量的类型转换的工作；  
● 使程序向32位windows的转化更简单；  
当然，使用消息分流器会大大改变程序的面貌，你也可以选择不使用它。  
下面我们就以一个对话框窗口的消息处理过程为例，看看消息分流器到底是怎么运作的。

### 1．消息分流器的基本使用 ###

先看一个普通的窗口消息处理函数，它可能需要处理一些窗口的初始化，无效客户区重绘等消息：

1 ![None.gif][] LRESULT CALLBACK WndProc (HWND hwnd, UINT msg,  
  2 ![None.gif][]WPARAM wParam, LPARAM lParam)  
  3 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] ![dot.gif][] \{  
 4![InBlock.gif][]switch(msg)  
 5![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]![dot.gif][]\{  
 6![InBlock.gif][]case WM\_CREATE:  
 7![InBlock.gif][]//![dot.gif][]  
 8![InBlock.gif][]return0;  
 9![InBlock.gif][]case WM\_PAINT:  
10![InBlock.gif][]//![dot.gif][]  
11![InBlock.gif][]return0;  
12![InBlock.gif][]case WM\_DESTROY:  
13![InBlock.gif][]//![dot.gif][]  
14![InBlock.gif][]return0;  
15![ExpandedSubBlockEnd.gif][]\}  
16![InBlock.gif][]return DefWindowProc(hwnd, msg, wParam, lParam);  
17![ExpandedBlockEnd.gif][]\}

而通过使用消息分流器，我们可以把每个case都写到相应的消息处理函数中，就像下面这样：

1 ![None.gif][] LRESULT CALLBACK WndProc (HWND hwnd, UINT msg,  
  2 ![None.gif][]WPARAM wParam, LPARAM lParam)  
  3 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] ![dot.gif][] \{  
 4![InBlock.gif][]switch(msg)  
 5![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]![dot.gif][]\{  
 6![InBlock.gif][]case WM\_CREATE:  
 7![InBlock.gif][]return HANDLE\_WM\_CREATE(hwnd, wParam, lParam, Cls\_OnCreate);  
 8![InBlock.gif][]case WM\_PAINT:  
 9![InBlock.gif][]return HANDLE\_WM\_PAINT(hwnd, wParam, lParam, Cls\_OnPaint);  
10![InBlock.gif][]case WM\_DESTROY:  
11![InBlock.gif][]return HANDLE\_WM\_DESTROY(hwnd, wParam, lParam, Cls\_OnDestroy);  
12![ExpandedSubBlockEnd.gif][]\}  
13![InBlock.gif][]return DefWindowProc(hwnd, msg, wParam, lParam);  
14![ExpandedBlockEnd.gif][]\}

这里用到了三个宏定义：HANDLE\_WM\_CREATE, HANDLE\_WM\_PAINT, HANDLE\_WM\_DESTROY；这三个宏定义就是我们的三个消息分流器（别看叫什么分流器，说穿了也不值几个钱，呵呵），它们在windowsx.h中的定义如下：

1 ![None.gif][] \#define  HANDLE\_WM\_CREATE(hwnd, wParam, lParam, fn)    
 2 ![None.gif][]((fn)((hwnd), (LPCREATESTRUCT)(lParam))  ?  0L  : (LRESULT) \- 1L )  
 3 ![None.gif][] \#define  HANDLE\_WM\_PAINT(hwnd, wParam, lParam, fn)    
 4 ![None.gif][]((fn)(hwnd),  0L )  
 5 ![None.gif][] \#define  HANDLE\_WM\_DESTROYCLIPBOARD(hwnd, wParam, lParam, fn)    
 6 ![None.gif][]((fn)(hwnd),  0L )

把这三个宏定义替换回去，就变成：

1 ![None.gif][] LRESULT CALLBACK WndProc (HWND hwnd, UINT msg,  
  2 ![None.gif][]WPARAM wParam, LPARAM lParam)  
  3 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] ![dot.gif][] \{  
 4![InBlock.gif][]switch(msg)  
 5![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]![dot.gif][]\{  
 6![InBlock.gif][]case WM\_CREATE:  
 7![InBlock.gif][]return Cls\_OnCreate(hwnd, (LPCREATESTRUCT)(lParam) ?0L : (LRESULT)\-1L;  
 8![InBlock.gif][]// 如果处理了消息，则Cls\_OnCreate应返回TRUE，导致WndProc返回0，否则Cls\_OnCreate返回FALSE，导致WndProc返回-1；  
 9![InBlock.gif][]case WM\_PAINT:  
10![InBlock.gif][]return Cls\_OnPaint(hwnd), 0L;  
11![InBlock.gif][]// 逗号表达式；Cls\_OnPaint是void类型，这里返回0；   
12![InBlock.gif][]case WM\_DESTROY:  
13![InBlock.gif][]return Cls\_OnDestroy(hwnd), 0L; // 同Cls\_OnPaint  
14![ExpandedSubBlockEnd.gif][]\}  
15![InBlock.gif][]return DefWindowProc(hwnd, msg, wParam, lParam);  
16![ExpandedBlockEnd.gif][]\}

之后我们就可以按照消息分流器的定义编写相应的消息处理函数了：

1 ![ExpandedBlockStart.gif][] ![ContractedBlock.gif][] BOOL Cls\_OnCreate(HWND hwnd, LPCREATESTRUCT lpCreateStruct) ![dot.gif][] \{…\} ;  
 2 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] void  Cls\_OnPaint(HWND hwnd) ![dot.gif][] \{…\} ;  
 3 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] void  Cls\_OnDestroyClipboard(HWND hwnd) ![dot.gif][] \{…\} ;

windowsx.h还提供了一个更加简化的方法：使用HANDLE\_MSG宏，这个宏是这样定义的：

1 ![None.gif][] \#define  HANDLE\_MSG(hwnd, message, fn)    
 2 ![None.gif][] case  (message):  return  HANDLE\_\#\#message((hwnd), (wParam), (lParam), (fn))

这个宏要做的就是根据不同的message（\#\#用来连接前后的字符串），把自己“变成”相应的HANDLE\_XXXXMESSAGE形式的宏，再通过相应的宏来执行消息处理代码；  
比如实际代码中写入：

1 ![None.gif][] HANDLE\_MSG(hwnd, WM\_CREATE, Cls\_OnCreate)

则经过转换就变成：

1 ![None.gif][] case  (WM\_CREATE):  return  HANDLE\_WM\_CREATE((hwnd), (wParam), (lParam), (Cls\_OnCreate));

这样，我们就可以直接把程序写为：

之后直接编写相应的消息处理过程就可以了。是不是简洁多了？而且把消息处理封装到函数里面，就可以使用VS直接跳转到这个函数，再也不用费劲去找那个 case了。要注意的一点是，虽然windowsx.h里包括了所有消息对应的分流器，但它们的参数是宏定义显式说明的，在编写消息处理函数时，必须遵循宏定义中的参数类型，否则会导致错误；这么多消息分流器，我们每次新写一个消息处理函数时就得看看是否把参数设置正确了，整个过程繁琐冗长。好在已经有一个工具叫Message Cracker Wizard，可以帮助我们生成消息分流器和相关的处理过程，具体见：  
http://www.codeproject.com/win32/msgcrackwizard.asp。

### 2．在对话框中使用消息分流器 ###

在对话框消息处理中，窗口子类化是我们经常使用的手段，这也可以通过消息分流器实现，但是有点小问题 :>  
下面是一个使用了windowsx.h消息分流器的对话框及其处理过程：

1 ![None.gif][] int  WINAPI \_tWinMain(HINSTANCE hinstExe, HINSTANCE, PTSTR pszCmdLine,  int )  
  2 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] ![dot.gif][] \{  
 3![InBlock.gif][]DialogBoxParam(  
 4![InBlock.gif][]hinstExe, MAKEINTRESOURCE(IDD\_PASSTHRU), NULL, (DLGPROC)Dlg\_Proc, 0);  
 5![InBlock.gif][]return(0);  
 6![ExpandedBlockEnd.gif][]\}   
  7 ![None.gif][]……  
  8 ![None.gif][]LRESULT CALLBACK Dlg\_Proc (HWND hwnd, UINT msg,  
  9 ![None.gif][]WPARAM wParam, LPARAM lParam)  
 10 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] ![dot.gif][] \{  
11![InBlock.gif][]switch(msg)  
12![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]![dot.gif][]\{  
13![InBlock.gif][]HANDLE\_MSG(hwnd, WM\_INITDIALOG, Cls\_OnInitDialog); // 不能直接使用HANDLE\_MSG宏  
14![InBlock.gif][]HANDLE\_MSG(hwnd, WM\_COMMAND, Cls\_OnCommand); // 不能直接使用HANDLE\_MSG宏  
15![ExpandedSubBlockEnd.gif][]\}  
16![InBlock.gif][]returnfalse;  
17![ExpandedBlockEnd.gif][]\}

以上程序中直接使用HANDLE\_MSG可能导致错误；为什么呢？问题出在子类化的消息处理过程的返回值上，msdn中对于对话框消息处理过程的返回值有如下说明：  
一般情况下，对话框过程函数应该在处理了消息的情况下返回TRUE，如果没有处理，则返回FALSE。如果对话框过程返回了FALSE，那么对话框管理器为这条消息准备默认的对话操作。  
如果对话框处理了一个需要特定返回值的消息，则对话框的返回值应该被设置为调用SetWindowLong(The SetWindowLong function changes an attribute of the specified window. The function also sets a 32-bit (long) value at the specified offset into the extra window memory of a window. )后的返回值，并在返回TRUE之前立即返回这个值。注意你必须立即调用SetWindowLong（这个函数用于调用窗口子类化的过程），这会导致DWL\_MSGRESULT值被一个嵌套的对话框消息改写。返回值为特定值的消息有：  
• WM\_CHARTOITEM  
• WM\_COMPAREITEM  
• WM\_CTLCOLORBTN  
• WM\_CTLCOLORDLG  
• WM\_CTLCOLOREDIT  
• WM\_CTLCOLORLISTBOX  
• WM\_CTLCOLORSCROLLBAR  
• WM\_CTLCOLORSTATIC  
• WM\_INITDIALOG  
• WM\_QUERYDRAGICON  
• WM\_VKEYTOITEM  
看到没有？ 我们的消息WM\_INITDIALOG也在其中，对这个消息进行处理的过程不能简单的返回TRUE表示对消息进行了处理，而是另有其意；它将转化为：

1 ![None.gif][] case  (WM\_INITDIALOG):  return  HANDLE\_WM\_INITDIALOG(hwnd, wParam, lParam, Cls\_OnInitDialog);

宏HANDLE\_WM\_INITDIALOG定义如下：

1 ![None.gif][] \#define  HANDLE\_WM\_INITDIALOG(hwnd, wParam, lParam, fn)    
 2 ![None.gif][](LRESULT)(DWORD)(UINT)(BOOL)(fn)((hwnd), (HWND)(wParam), lParam)

对WM\_INITDIALOG的处理，如果返回TRUE，则表示设置键盘焦点到对话框的默认控件，否则返回FALSE；这时好像还看不出什么问题，而对于我们的另外一个消息WM\_COMMAND，HANDLE\_MSG简单的把它变成：

1 ![None.gif][] case  (WM\_COMMAND):  return  HANDLE\_WM\_COMMAND(hwnd, wParam, lParam, Cls\_OnCommand);

宏HANDLE\_WM\_COMMAND定义如下：

1 ![None.gif][] \#define  HANDLE\_WM\_COMMAND(hwnd, wParam, lParam, fn)    
 2 ![None.gif][]((fn)((hwnd), ( int )(LOWORD(wParam)), (HWND)(lParam), (UINT)HIWORD(wParam)),  0L )

问题出来了，我们的Cls\_OnCommand由于是个void型的函数，是没有返回值的，因此windows默认这种消息处理过程必须返回一个0值，而返回0值不就表示我们的消息过程不处理这个消息么？这个矛盾是HANDLE\_MSG无法解决的。怎么办才能使消息过程在处理完WM\_COMMAND消息之后正确的返回一个TRUE呢？ 答案是使用另一个windowsx.h中的宏：SetDlgMsgResult(hwnd, msg, result)  
这个宏定义如下：

1 ![None.gif][] \#define  SetDlgMsgResult(hwnd, msg, result) ((    
  2 ![None.gif][](msg)  ==  WM\_CTLCOLORMSGBOX  ||   
  3 ![None.gif][](msg)  ==  WM\_CTLCOLOREDIT  ||   
  4 ![None.gif][](msg)  ==  WM\_CTLCOLORLISTBOX  ||   
  5 ![None.gif][](msg)  ==  WM\_CTLCOLORBTN  ||   
  6 ![None.gif][](msg)  ==  WM\_CTLCOLORDLG  ||   
  7 ![None.gif][](msg)  ==  WM\_CTLCOLORSCROLLBAR  ||   
  8 ![None.gif][](msg)  ==  WM\_CTLCOLORSTATIC  ||   
  9 ![None.gif][](msg)  ==  WM\_COMPAREITEM  ||   
 10 ![None.gif][](msg)  ==  WM\_VKEYTOITEM  ||   
 11 ![None.gif][](msg)  ==  WM\_CHARTOITEM  ||   
 12 ![None.gif][](msg)  ==  WM\_QUERYDRAGICON  ||   
 13 ![None.gif][](msg)  ==  WM\_INITDIALOG  
 14 ![None.gif][])  ?  (BOOL)(result) : (SetWindowLongPtr((hwnd), DWLP\_MSGRESULT, (LPARAM)(LRESULT)(result)), TRUE))

（有没有注意到，里面多了一个WM\_CTLCOLORMSGBOX ？ 这个消息是16位WinAPI中的消息，一度被转换为Win32 API的一个消息；现在在最新的32位API中已经被删除了；保留它可能考虑到兼容性的问题，这里不做进一步讨论）  
现在看到了，如果对话框过程处理的消息恰巧为返回特定值中的一个，则如实返回result；不要被前面的BOOL蒙蔽，BOOL在头文件中的定义实际上是一个int型，一旦需要返回非TRUE或FALSE的其他值，照样可以；这样，我们的Cls\_OnInitDialog就能够正确的返回它的BOOL值了，而Cls\_OnCommand在处理之后，也可以由后面的逗号表达式正确的返回一个TRUE表示消息已处理。  
在《Windows核心编程》一书中，大牛Jeffrey自己定义了一个宏，使SetDlgMsgResult宏的使用更加方便：

1 ![None.gif][] \#define  chHANDLE\_DLGMSG(hwnd, message, fn)    
 2 ![None.gif][] case  (message):  return  (SetDlgMsgResult(hwnd, uMsg,  
 3 ![None.gif][]HANDLE\_\#\#message((hwnd), (wParam), (lParam), (fn))))

可见这个宏只是简单的对SetDlgMsgRseult宏进行了封装。  
这样，我们最终的代码可以写成：

1 ![None.gif][] LRESULT CALLBACK Dlg\_Proc (HWND hwnd, UINT msg,  
  2 ![None.gif][]WPARAM wParam, LPARAM lParam)  
  3 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] ![dot.gif][] \{  
 4![InBlock.gif][]switch(msg)  
 5![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]![dot.gif][]\{  
 6![InBlock.gif][]chHANDLE\_DLGMSG(hwnd, WM\_INITDIALOG, Cls\_OnInitDialog); // 使用大牛的chHANDLE\_DLGMSG宏  
 7![InBlock.gif][]chHANDLE\_DLGMSG(hwnd, WM\_COMMAND, Cls\_OnCommand);  
 8![ExpandedSubBlockEnd.gif][]\}  
 9![InBlock.gif][]returnfalse;  
10![ExpandedBlockEnd.gif][]\}

下面把原来程序整个框架列出来：

1 ![None.gif][] LRESULT CALLBACK Dlg\_Proc(HWND hwnd, UNIT umsg, WPARAM wparam, LPARAM lparam)  
  2 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] ![dot.gif][] \{  
 3![InBlock.gif][]switch(msg)  
 4![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]![dot.gif][]\{  
 5![InBlock.gif][]case WM\_COMMAND: // 每个case都被一个message cracker代替，这里使用大牛同志的  
 6![InBlock.gif][]// do something; // chHANDLE\_DLGMSG宏；这个宏负责对消息筛选，处理并返回相应的值  
 7![InBlock.gif][]returntrue;  
 8![InBlock.gif][]case WM\_INITDIALOG:  
 9![InBlock.gif][]// do something;  
10![InBlock.gif][]return xxxx;  
11![ExpandedSubBlockEnd.gif][]\}  
12![InBlock.gif][]returnfalse; // 如果消息不在我们的DlgProc过程中被处理，则告诉调用这个DlgProc的消息，  
13![ExpandedBlockEnd.gif][]\}  // 告诉系统的对话框管理器，这个消息我们不处理，交给你了

对比一下，消息分流器的作用不言自明。  
以上只是介绍了消息分流器的部分应用，更多创造性的用法还等你自己在实践中发掘。

文章作者：Bideyore\[E.S.T\]

转自：[http://www.cnblogs.com/phonefans/archive/2009/01/07/1371301.html][http_www.cnblogs.com_phonefans_archive_2009_01_07_1371301.html]

[None.gif]: /images/20220806/16da7e5256e5443384d7085d455c1989.png
[ExpandedBlockStart.gif]: http://www.cnblogs.com/Images/OutliningIndicators/ExpandedBlockStart.gif
[ContractedBlock.gif]: http://www.cnblogs.com/Images/OutliningIndicators/ContractedBlock.gif
[dot.gif]: /images/20220806/241118d5a9414f9f9fe4e94dedae0b00.png
[InBlock.gif]: /images/20220806/c7fa23b405914409bd09deb7f1eba7a7.png
[ExpandedSubBlockStart.gif]: http://www.cnblogs.com/Images/OutliningIndicators/ExpandedSubBlockStart.gif
[ContractedSubBlock.gif]: http://www.cnblogs.com/Images/OutliningIndicators/ContractedSubBlock.gif
[ExpandedSubBlockEnd.gif]: /images/20220806/8a65c105c45148ca80052e530331aec0.png
[ExpandedBlockEnd.gif]: /images/20220806/f5fbb4a355dc4d77b655567bb3d865ae.png
[http_www.cnblogs.com_phonefans_archive_2009_01_07_1371301.html]: http://www.cnblogs.com/phonefans/archive/2009/01/07/1371301.html