当_WIN32_WINNT大于0x500时，ToolTip窗口不显示问题排查

忘是亡心i 2024-04-17 11:16 54阅读 0赞

**目录**

1、前言

2、回退代码后，ToolTip窗口不显示了

3、使用历史版本比对法找到ToolTip窗口何时开始不显示的

4、为了给字体设置ClearType属性，\_WIN32\_WINNT宏的值从0x500修改成0x501

5、将\_WIN32\_WINNT宏值由从0x500修改成0x501，导致系统的ToolTip窗口组件出问题

6、解决办法

--------------------

[C++软件异常排查从入门到精通系列教程（专栏文章列表，欢迎订阅，持续更新...）![icon-default.png?t=N7T8][icon-default.png_t_N7T8]https://blog.csdn.net/chenlycly/article/details/125529931][C_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_article_details_125529931][C/C++基础与进阶（专栏文章，持续更新中...）![icon-default.png?t=N7T8][icon-default.png_t_N7T8]https://blog.csdn.net/chenlycly/category\_11931267.html][C_C_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_category_11931267.html][VC++常用功能开发汇总（专栏文章列表，欢迎订阅，持续更新...）![icon-default.png?t=N7T8][icon-default.png_t_N7T8]https://blog.csdn.net/chenlycly/article/details/124272585][VC_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_article_details_124272585][C++软件分析工具从入门到精通案例集锦（专栏文章，持续更新中...）![icon-default.png?t=N7T8][icon-default.png_t_N7T8]https://blog.csdn.net/chenlycly/article/details/131405795][C_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_article_details_131405795][开源组件及数据库技术（专栏文章，持续更新中...）![icon-default.png?t=N7T8][icon-default.png_t_N7T8]https://blog.csdn.net/chenlycly/category\_12458859.html][..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_category_12458859.html][网络编程与网络问题分享（专栏文章，持续更新中...）![icon-default.png?t=N7T8][icon-default.png_t_N7T8]https://blog.csdn.net/chenlycly/category\_2276111.html][..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_category_2276111.html]

### 1、前言 ###

最近测试同事发现，在Slider滑块控件显示百分比的ToolTip时有问题，即*在拖动滑块时ToolTip窗口没有显示实时的百分比，显示的还是之前的百分比*，如下所示：

![3af01ebaa7a54b0a912b065ed30ed091.png][]

在排查这个问题的过程中遇到了一系列问题，在此做个总结，以供大家借鉴和参考。

### 2、回退代码后，ToolTip窗口不显示了 ###

这个问题是必现的。用老版本对比了一下，老版本中这个滑块控件的ToolTip显示是没有问题的。那说明这个问题肯定是修改代码，改出来的。于是，到svn上查看代码的修改记录，果然前段时间有人修改过相关代码。于是尝试将修改的代码还原，看看还没有问题，验证一下是不是这次修改引起的。

**将代码还原之后，重新编译执行，****发现问题更严重了，ToolTip提示窗口直接不显示了****。**这就有点奇怪了，老版本中是没问题的，估计更早的时候还有人修改过代码，导致ToolTip提示窗口不显示了。

--------------------

在这里，给大家**重点推荐一下我的几个热门畅销专栏：**

**专栏1：**（该专栏订阅量已达到400个，有很强的实战参考价值，广受好评！专栏文章持续更新中，预计更新到200篇以上！）

[C++软件调试与异常排查从入门到精通系列文章汇总![icon-default.png?t=N7T8][icon-default.png_t_N7T8]https://blog.csdn.net/chenlycly/article/details/125529931][C_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_article_details_125529931]

> 本专栏根据近几年C++软件异常排查的项目实践，系统地总结了引发C++软件异常的常见原因以及排查C++软件异常的常用思路与方法，**详细讲述了C++软件的调试方法与手段，以图文并茂的方式给出具体的实战问题分析实例**，带领大家逐步掌握C++软件调试与异常排查的相关技术，适合基础进阶和想做技术提升的相关C++开发人员！
> 
> **专栏中的文章均是通过项目实战总结出来的**（通过项目实战积累了大量的异常排查素材和案例），有很强的实战参考价值！专栏文章还在持续更新中，预计文章篇数能更新到200篇以上！

**专栏2：**

[C/C++基础与进阶（专栏文章，持续更新中...）![icon-default.png?t=N7T8][icon-default.png_t_N7T8]https://blog.csdn.net/chenlycly/category\_11931267.html][C_C_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_category_11931267.html]

> 以多年的开发实战为基础，总结并讲解一些的C/C++基础与进阶内容，以图文并茂的方式对相关知识点进行详细地展开与阐述！专栏涉及了C/C++领域的多个方面的内容，同时给出C/C++及网络方面的常见笔试面试题，并详细讲述Visual Studio常用调试手段与技巧！

**专栏3：**

[开源组件及数据库技术![icon-default.png?t=N7T8][icon-default.png_t_N7T8]https://blog.csdn.net/chenlycly/category\_12458859.html][..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_category_12458859.html]

> 以多年的开发实战为基础，分享一些开源组件及数据库技术！

--------------------

### 3、使用历史版本比对法找到ToolTip窗口何时开始不显示的 ###

我们之前讲过可以**使用历史版本比对法去排查一些问题，即安装不同时间点的版本，看看问题是从哪个时间点开始出现的。找到这个时间点后，****大概就是前一天提交的代码或者底层发布过来的新dll库导致的。**

于是使用二分法安装不同时间点的版本，发现之前的版本长时间都有ToolTip不显示的问题，一直没有人反馈，所有界面的ToolTip都有问题。一直找到一年前的某个版本没有问题。于是继续使用二分法缩小范围，最终找到ToolTip窗口从那一天开始不显示的。

于是到svn上查看前一天的代码修改记录，在directui库的Stdafx.h头文件中定义了\_WIN32\_WINNT宏，用该宏指定当前程序支持的最低操作系统版本，**将该\_WIN32\_WINNT宏的值由0x500改成了0x501，事后证明正是这个修改导致的ToolTip窗口不显示的。**

### 4、为了给字体设置ClearType属性，\_WIN32\_WINNT宏的值从0x500修改成0x501 ###

为什么要将\_WIN32\_WINNT宏的值从0x500修改成0x501呢？当时我们的软件在设置高DPI的电脑上运行，系统会对软件界面进行放大，放大后字体会比较模糊，为了将文字显示的更清晰一点，给绘制文字的字体设置ClearType属性，这样绘制出来的文字会更有棱角一点，会清晰一些。操作系统也支持设置ClearType选项，如下所示：

![f02a3d5384a44c3198178392681573ee.png][]

如何给字体设置ClearType属性呢？我们在使用LOGFONT结构体创建字体时，直接给LOGFONT结构体中的lfQuality字段设置CLEARTYPE\_QUALITY值即可，如下所示：

![d16fd792b41b47348e4a35a780ca3490.png][]

跳转到CLEARTYPE\_QUALITY宏的定义处：

![8c62506ce80b46a7ad42ac78dd7c30fb.png][]

![5cfb91ff692846878bfd955149c134f7.png][]

可以看到只有当定义的NT版本达到0x501，才定义这个CLEARTYPE\_QUALITY宏，但我们的directui工程中将\_WIN32\_WINNT宏值定义为0x500，**于是为了支持CLEARTYPE\_QUALITY宏，直接\_WIN32\_WINNT的值由0x500改成0x501。**

### 5、将\_WIN32\_WINNT宏值由从0x500修改成0x501，导致系统的ToolTip窗口组件出问题 ###

开始出问题的时间点之前值只对这个\_WIN32\_WINNT宏值做了修改，难道是这个宏值对系统的ToolTip窗口也有影响？于是**将\_WIN32\_WINNT宏的值重新改成0x500****，将使用CLEARTYPE\_QUALITY宏的代码注释掉，重新编译运行，****ToolTip窗口就能正常显示了。果然与\_WIN32\_WINNT宏的值有关系！**

那将\_WIN32\_WINNT宏的值设置成为0x501，为啥会导致ToolTip窗口组件出问题呢？这个要看ToolTip窗口对应的结构体TOOLINFO，可以跳转到这个结构体的定义处，如下所示：

![242a752f11c84f079841f84f2daa8793.png][]

TOOLINFO最后一个字段是void \*lpReserved，这个字段有点特殊，当NTDDI\_VERSION大于NTDDI\_WINXP时才会定义。

我们可以go到这两个宏的定义处，**NTDDI\_WINXP宏的值为0x05010000**：

![6d1ce2af72304c5b85b8aa497b9e0b91.png][]

而NTDDI\_VERSION是直接与\_WIN32\_WINNT相关的：

![2027e6b6344e4da2a5c5aec153e209d1.png][]

本例中我们**将\_WIN32\_WINNT宏改成0x501，所以\#if (NTDDI\_VERSION >= NTDDI\_WINXP)条件为真，所以****当前场景下，TOOLINFO最后一个字段void \*lpReserved是有效的****！**

我们在定义TOOLINFO结构体对象时，给该结构体的cbSize字段赋值的是sizeof(TOOLINFO)：

![01c86ccccc79424daa9a706be7116ad0.png][]

即当前TOOLINFO结构体的大小，包含void \*lpReserved字段的。**而****Windows系统默认加载的是comctl 5.82版本组件****，这个版本中的ToolTip组件对应的****TOOLINFO结构体中的size不包含void \*lpReserved字段****，而我们当前****给cbSize字段设置的大小是包含void \*lpReserved的****，所以****cbSize字段设大了****，所以ToolTip组件内部出错了，导致ToolTip窗口显示不出来了。**

在Win32编程中使用ToolTip窗口组件时，先是调用CreateWindowEx创建一个TOOLTIPS\_CLASS类窗口，然后给这个窗口发送TTM\_ADDTOOL消息将定义的TOOLINFO结构体对象值（TOOLINFO结构体中存放的是给ToolTip窗口设置属性），如下所示：

![a83b0ae465f64c2f97ceec717e843c92.png][]

应该是这一步设置进去后就出问题了。

### 6、解决办法 ###

**在给TOOLINFO结构体对象的****cbSize字段赋值****时，不再赋sizeof(TOOLINFO)，而是****赋TTTOOLINFOA\_V2\_SIZE宏值**：

::ZeroMemory(&m_ToolTip, sizeof(TOOLINFO));
    
    // 赋值为TTTOOLINFOA_V2_SIZE，不用sizeof(TOOLINFO)
    m_ToolTip.cbSize = TTTOOLINFOA_V2_SIZE;

这个宏值就是将void \*lpReserved字段去除后的TOOLINFO结构体大小。可以查看TTTOOLINFOA\_V2\_SIZE宏的定义看出来：

#define TTTOOLINFOA_V1_SIZE CCSIZEOF_STRUCT(TTTOOLINFOA, lpszText)
    #define TTTOOLINFOW_V1_SIZE CCSIZEOF_STRUCT(TTTOOLINFOW, lpszText)
    
    // 1、TTTOOLINFOW_V2_SIZE宏的定义
    #define TTTOOLINFOA_V2_SIZE CCSIZEOF_STRUCT(TTTOOLINFOA, lParam)
    #define TTTOOLINFOW_V2_SIZE CCSIZEOF_STRUCT(TTTOOLINFOW, lParam)
    #define TTTOOLINFOA_V3_SIZE CCSIZEOF_STRUCT(TTTOOLINFOA, lpReserved)
    #define TTTOOLINFOW_V3_SIZE CCSIZEOF_STRUCT(TTTOOLINFOW, lpReserved)
    
    
    // 2、CCSIZEOF_STRUCT宏的定义
    #ifndef CCSIZEOF_STRUCT
    #define CCSIZEOF_STRUCT(structname, member)  (((int)((LPBYTE)(&((structname*)0)->member) - ((LPBYTE)((structname*)0)))) + sizeof(((structname*)0)->member))
    #endif
    
    
    // 3、TTTOOLINFO宏的定义
    typedef struct tagTOOLINFOW {
        UINT cbSize;
        UINT uFlags;
        HWND hwnd;
        UINT_PTR uId;
        RECT rect;
        HINSTANCE hinst;
        LPWSTR lpszText;
        LPARAM lParam;
    #if (NTDDI_VERSION >= NTDDI_WINXP)
        void *lpReserved;
    #endif
    } TTTOOLINFOW, NEAR *PTOOLINFOW, *LPTTTOOLINFOW;

根据TTTOOLINFOA\_V2\_SIZE的定义，TTTOOLINFOA\_V2\_SIZE就是只计算到TOOLINFO倒数第二个参数lParam的长度，包含lParam成员长度，正好将最后一个字段void \*lpReserved给跳过去了，这样ToolTip就能正常显示了。

**也可以使用\#pragma comment预编译指令，****将comctrl指定为使用6.0版本****的**：

> \#pragma comment(linker, "\\"/manifestdependency:type='Win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' processorArchitecture='X86' publicKeyToken='6595b64144ccf1df' language='\*'\\"")

对应范例如下：

#include <windows.h>
    #include <commctrl.h>
    #include <stdio.h>
    
    #pragma comment(lib, "user32.lib")
    #pragma comment(lib, "comctl32.Lib")
    #pragma comment(lib, "gdi32.Lib")
    
    #pragma comment(linker, "\"/manifestdependency:type='Win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' processorArchitecture='X86' publicKeyToken='6595b64144ccf1df' language='*'\"")

[icon-default.png_t_N7T8]: https://csdnimg.cn/release/blog_editor_html/release2.3.6/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=N7T8
[C_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_article_details_125529931]: https://blog.csdn.net/chenlycly/article/details/125529931
[C_C_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_category_11931267.html]: https://blog.csdn.net/chenlycly/category_11931267.html
[VC_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_article_details_124272585]: https://blog.csdn.net/chenlycly/article/details/124272585
[C_..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_article_details_131405795]: https://blog.csdn.net/chenlycly/article/details/131405795
[..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_category_12458859.html]: https://blog.csdn.net/chenlycly/category_12458859.html
[..._icon-default.png_t_N7T8_icon-default.png_t_N7T8_https_blog.csdn.net_chenlycly_category_2276111.html]: https://blog.csdn.net/chenlycly/category_2276111.html
[3af01ebaa7a54b0a912b065ed30ed091.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/694ec381fc79466fa8375fc91dd26b93.png
[f02a3d5384a44c3198178392681573ee.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/03da411a518b47c7a4d0d0c1af529321.png
[d16fd792b41b47348e4a35a780ca3490.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/c708b51fb2df4cf9b2eee7e505a751fe.png
[8c62506ce80b46a7ad42ac78dd7c30fb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/0e0951672d4e468f85eb990273b6967d.png
[5cfb91ff692846878bfd955149c134f7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/2f5ff9bcc7dd461191ba6a669b6a5df6.png
[242a752f11c84f079841f84f2daa8793.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/5ba90de803884050a7b9ba3a38694709.png
[6d1ce2af72304c5b85b8aa497b9e0b91.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/9906858504fb40278db7334607f3b996.png
[2027e6b6344e4da2a5c5aec153e209d1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/48ab279f92e3495fbed3701fe4147b7e.png
[01c86ccccc79424daa9a706be7116ad0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/6e6371cd45ac4969ba0cbd21fe9a3a9f.png
[a83b0ae465f64c2f97ceec717e843c92.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/00c087eaadd6496093a01e9026f144f8.png