Win32 API场景下禁用窗口无法显示Tooltip提示框如何解决

核心原因 #

调用EnableWindow(hWnd, FALSE)将窗口标记为禁用后，系统不会向该窗口分发任何鼠标/键盘输入消息，默认使用TTF_SUBCLASS子类化模式的Tooltip依赖目标窗口的消息回调触发，因此无法正常弹出。

可行规避方案 #

方案1：使用TTF_DISABLED标志（推荐，适用于ComCtl32 v6及以上版本） #

从公共控件库v6版本开始，Tooltip原生支持为禁用窗口提供提示，只需要修改TTTOOLINFO的uFlags配置即可：

• 在原有TTF_SUBCLASS基础上追加TTF_DISABLED标志
• 窗口启用/禁用状态切换时，发送TTM_UPDATETIPTEXT消息更新Tooltip文本即可实现两种状态的不同提示

修改后的创建代码示例：

void CreateTooltip(HWND hparent)
{
    HWND hwndTT = CreateWindowEx(WS_EX_TOPMOST, TOOLTIPS_CLASS, NULL,
        WS_POPUP | TTS_NOPREFIX | TTS_ALWAYSTIP, 0, 0, 0, 0, 
        hparent, NULL, hInstance, NULL);

    TTTOOLINFO ti = { 0 };
    ti.cbSize = TTTOOLINFOW_V2_SIZE;
    // 追加TTF_DISABLED支持禁用窗口提示
    ti.uFlags = TTF_SUBCLASS | TTF_DISABLED;
    ti.hwnd = hparent;
    ti.lpszText = (LPWSTR)L"启用状态提示文本";
    GetClientRect(hparent, &ti.rect);

    if (!SendMessage(hwndTT, TTM_ADDTOOL, 0, (LPARAM)&ti))
        MessageBox(0, TEXT("Failed: TTM_ADDTOOL"), 0, 0);
}

状态切换时更新提示文本的示例：

// 切换窗口为禁用状态时更新Tooltip
EnableWindow(hWnd, FALSE);
TTTOOLINFO ti = {0};
ti.cbSize = TTTOOLINFOW_V2_SIZE;
ti.hwnd = hWnd;
ti.lpszText = (LPWSTR)L"禁用状态提示文本";
SendMessage(hwndTT, TTM_UPDATETIPTEXT, 0, (LPARAM)&ti);

方案2：手动拦截鼠标消息实现（兼容旧版本系统） #

如果需要兼容Windows XP等不支持ComCtl32 v6的环境，可以采用手动检测的方式：

• 不要给目标窗口绑定Tooltip的子类化规则
• 在目标窗口的父窗口消息回调中处理WM_MOUSEMOVE消息，通过ScreenToClient转换坐标后，使用PtInRect判断鼠标是否落在禁用窗口的区域内
• 手动调用TTM_TRACKACTIVATE、TTM_TRACKPOSITION控制Tooltip的显示位置和文本内容

内容的提问来源于stack exchange，提问作者Oleg