如何在不绑定工具的情况下使用 Windows 工具提示控件

Posted 2023-02-22

【中文标题】如何在不绑定工具的情况下使用 Windows 工具提示控件

【英文标题】：How to use Windows ToolTip Control without bounding to a tool

【发布时间】：2011-08-19 06:09:21

【问题描述】：

我想使用原生 Windows 工具提示控件（纯 Win32 API，没有 MFC 的东西）。

我阅读了文档，看来我必须发送 TTM_ADDTOOL 消息才能将工具绑定到工具提示控件。只有在那之后，我才能发送 TTM_TRACKACTIVATE 和 TTM_TRACKPOSITION 来显示工具提示。

但我想在任何我想要的地方显示工具提示。例如，当鼠标悬停在我窗口的某个区域上时。这个区域不是 Windows 眼中的工具，它只是我窗口中的一个区域。

也许我可以将窗口绑定到工具提示控件，但是，这是否意味着我必须将我创建的每个窗口都绑定到工具提示控件？

有没有简单的解决方案，让我不必为每个窗口发送 TTM_ADDTOOL 消息？

---

我实际上已经编写了一些代码，但是工具提示没有出现。安德斯的回答实际上解决了一些问题。在我浏览了我的代码之后，我让它工作了。

如果有人想知道它是如何工作的：

HWND toolTipWnd = ::CreateWindowExW(WS_EX_TOPMOST,
            TOOLTIPS_CLASSW,0,WS_POPUP | TTS_NOPREFIX | TTS_ALWAYSTIP,
        CW_USEDEFAULT, CW_USEDEFAULT,CW_USEDEFAULT,CW_USEDEFAULT,
        0,0,appHandle,0);

TOOLINFOW ti = ;
ti.cbSize = sizeof(TOOLINFOW);
ti.uFlags = TTF_ABSOLUTE | TTF_IDISHWND /* | TTF_TRACK */; // Don't specify TTF_TRACK here. Otherwise the tooltip won't show up.
ti.hwnd   = toolTipWnd; // By doing this, you don't have to create another window.
ti.hinst  = NULL;
ti.uId    = (UINT)toolTipWnd;
ti.lpszText = L"";

::SendMessageW(toolTipWnd, TTM_ADDTOOLW, 0, (LPARAM)&ti);
::SendMessageW(toolTipWnd, TTM_SETMAXTIPWIDTH,0, (LPARAM)350);

这将创建一个不绑定到任何其他窗口的工具提示窗口。 因此，当您想显示工具提示时（例如，在响应 WM_MOUSEHOVER 消息时），请调用：

TOOLINFOW ti = ;
ti.cbSize   = sizeof(TOOLINFOW);
ti.hwnd     = toolTipWnd;
ti.uId      = (UINT)toolTipWnd;
ti.lpszText = L"Sample Tip Text";
::SendMessageW(toolTipWnd,TTM_UPDATETIPTEXTW,0,(LPARAM)&ti); // This will update the tooltip content.
::SendMessageW(toolTipWnd,TTM_TRACKACTIVATE,(WPARAM)TRUE,(LPARAM)&ti);
::SendMessageW(toolTipWnd, TTM_TRACKPOSITION,0,(LPARAM)MAKELONG(x,y)); // Update the position of your tooltip. Screen coordinate.
//::SendMessageW(toolTipWnd,TTM_POPUP,0,0); // TTM_POPUP not working.. Don't know why.

【参考方案1】：

您需要至少调用一次 TTM_ADDTOOL，没有它 AFAIK 就无法调用 TTM_SETTOOLINFO 或获取 TTN_GETDISPINFO。

如果您的目标是 XP+，您可以使用 TTM_POPUP 在任何位置和任何时间显示提示（但您需要自己处理初始延迟，除非您想要跟踪工具提示）

通常您调用 TTM_ADDTOOL 并将其与矩形 (TOOLINFO.rect) 或子窗口相关联，或者您可以将文本设置为 LPSTR_TEXTCALLBACK 并在所有内容都有提示时处理 TTN_GETDISPINFO。 MSDN 有一些sample code 你应该看看...

【讨论】：

好的。我终于解决了这个问题。使用本机 Win32 API 是一件令人头疼的事情。我可以用 TTM_POPUP 让它工作，但我用 TTM_TRACKPOSITION 解决它。

【参考方案2】：

添加 Windows 10（Visual Studio 2015，Win32 控制台应用程序）

#include "Commctrl.h"                   
#pragma comment (lib,"comctl32.lib")    
#pragma comment(linker,"\"/manifestdependency:type='win32' \
name='Microsoft.Windows.Common-Controls' version='6.0.0.0' \
processorArchitecture='*' publicKeyToken='6595b64144ccf1df' language='*'\"")

TOOLINFOW ti = ;
ti.cbSize = sizeof(TOOLINFOW);
ti.uFlags = TTF_ABSOLUTE | TTF_IDISHWND | TTF_TRACK ; // WITH TTF_TRACK! Otherwise the tooltip doesn't follow TTM_TRACKPOSITION message!
ti.hwnd = toolTipWnd;                       
ti.hinst = 0;
ti.uId = (UINT)toolTipWnd;
ti.lpszText = L"";

LRESULT result; 
int error; 
if (!SendMessageW(toolTipWnd, TTM_ADDTOOLW, 0, (LPARAM)&ti)) 
    MessageBox(NULL, L"Couldn't create the ToolTip control.", L"Error", MB_OK);
    error = 0;
    error = GetLastError();

if (!SendMessageW(toolTipWnd, TTM_SETMAXTIPWIDTH, 0, (LPARAM)350)) 
    MessageBox(NULL, L"Couldn't create the ToolTip control.", L"Error", MB_OK);
    error = 0;
    error = GetLastError();