完善 CPopupText 类

本文示例源代码或素材下载

“介绍一个有Toolbar功能的可重用类 CPopupText”。这篇文章的内容是关于在一个列表框中，如果列表框中数据项的文字长度超过了列表框本身的宽度，则会显示一个类似ToolTips的弹出提示，将超长的列表框数据项完整地显示出来（如图一）。文中给出的 CPopupText 类非常好用，但是该文章提供的例子代码——ListCtrl运行起来似乎有点问题，就是在单击提示条下面的列表框数据项时，无法选中这个项目。如果能完善一下就好了......

图一 显示弹出式提示

解答：

提出这个问题的朋友很细心。确实不错，稍微认真一点的人都不难发现这个例子中存在着上面所说的bug。本文将针对这个问题对程序进行修改和完善。

这个例子程序使用了一个特别的类——CListBoxTipHandler，它的作用是截获发送到列表框的消息。这个类派生于CSubclassWnd，请读者们注意，CSubclassWnd是个非常有用的类，它易于使用，可重用性极强。在VC知识库的很多文章和例子代码中都使用到了这个类（在其它的商业开发中当然也可以利用这个类）。这个类的作用是将截获的 Windows 消息发送到另外一个窗口。CListBoxTipHandler类还用到了另一个类——CPopupText，这个类的作用是显示超长的列表框项目文本。下面我们就来分析一下要实现的目标。

当用户点击弹出的提示条文本时（如图一），要想让 Windows 忽略提示文本的存在，让鼠标单击事件穿透文本直接传到下面的列表框是行不通的。那么如何让才能让鼠标单击事件传到列表框呢？Windows 自有其绝招。

当用户在屏幕的某个地方点击鼠标时，Windows 通过其内部机制来决定光标下面是什么东西，在发送WM_LBUTTONDOWN消息之前，Windows 首先要发送WM_NCHITTEST消息来查询光标处于哪个非客户区上方。如果光标在标题上方，则 Windows 返回HTCAPTION。如果光标处于菜单上方，则 Windows 返回HTMENU。如果光标落在客户区，则 Windows 返回HTCLIENT。大多数应用程序都不处理WM_NCHITTEST消息——一般这个消息都是由缺省的窗口过程(DefWindowProc)处理，所以可能有些人从来就没有听说过有这么一个Windows消息。DefWindowProc 进行所有相应的计算来确定像素是否落在标题，菜单，边界，大小调整客户区等区域，同时返回相应的HT码。在这些返回的HT码中有一个HTTRANSPARENT。这个返回码是我们分场感兴趣的东西。它告诉Windows，“我是透明的，不要把任何鼠标事件消息发给我，把它们发给下一个窗口吧。”这里所说的下一个窗口，指的是光标下面Z-坐标上的窗口线程。实际上这就是我们所需要的东西——对CPopupText类做如下修改：

UINT CPopupText::OnNcHitTest(CPoint pt)
{
　return HTTRANSPARENT;
}

哈哈，就这么简单，bug排除了！现在当用户单击如图一中的提示文本时，它下面的列表框被选中。真神！我喜欢这样用只有一行代码的函数就能搞掂的bug。它证明了最初的设计并不令人失望，尽管它不是那么完美。

但是出现了另外一个问题，当用户点击文本时，程序没有任何响应。列表框的数据项是被选中了，但用户得不到这个消息和信息。怎么办呢？这里告诉你一个用于界面设计的头号基本准则：即无论发生什么事情，都要让用户知道......

这个时候点击鼠标是非常令人不安的，因为想知道到底是选中了还是没有选中？为了给用户一些反馈，只需要在CListBoxTipHandler::WindowProc中添加几行代码即可，这个函数截获发送到列表框的消息。

LRESULT CListBoxTipHandler::WindowProc(...)
{
　　if (msg==WM_LBUTTONDOWN) {
　　g_wndTip.Cancel(); // 清楚提示文本
　　break;
　}
　return CSubclassWnd::WindowProc(msg, wp, lp);
}

现在当用户选中列表框数据项时，CListBoxTipHandler截获单击消息并进行处理，清除弹出得提示文本（如果有的话），并显示新选中的数据项，如图二所：

图二 选中项目后，提示消失

到此这个bug被完全排除......

原来CPopupText类使用的是缺省的状态字体(NONCLIENTMETRICS::lfStatusFont)。如果使用与列表框同样的字体效果会更好些，所以我在这方面也进行了改进。