在对工具提示对象执行TTM_ADDTOOL时传递两个 HWND 句柄有什么意义?



在这个MSDN代码示例中:

// Description:
//   Creates a tooltip for an item in a dialog box. 
// Parameters:
//   idTool - identifier of an dialog box item.
//   nDlg - window handle of the dialog box.
//   pszText - string to use as the tooltip text.
// Returns:
//   The handle to the tooltip.
//
HWND CreateToolTip(int toolID, HWND hDlg, PTSTR pszText)
{
    if (!toolID || !hDlg || !pszText)
    {
        return FALSE;
    }
    // Get the window of the tool.
    HWND hwndTool = GetDlgItem(hDlg, toolID);
    
    // Create the tooltip. g_hInst is the global instance handle.
    HWND hwndTip = CreateWindowEx(NULL, TOOLTIPS_CLASS, NULL,
                              WS_POPUP |TTS_ALWAYSTIP | TTS_BALLOON,
                              CW_USEDEFAULT, CW_USEDEFAULT,
                              CW_USEDEFAULT, CW_USEDEFAULT,
                              hDlg, NULL, 
                              g_hInst, NULL);
    
   if (!hwndTool || !hwndTip)
   {
       return (HWND)NULL;
   }                              
                              
    // Associate the tooltip with the tool.
    TOOLINFO toolInfo = { 0 };
    toolInfo.cbSize = sizeof(toolInfo);
    toolInfo.hwnd = hDlg;                          // first HWND
    toolInfo.uFlags = TTF_IDISHWND | TTF_SUBCLASS;
    toolInfo.uId = (UINT_PTR)hwndTool;             // second HWND
    toolInfo.lpszText = pszText;
    SendMessage(hwndTip, TTM_ADDTOOL, 0, (LPARAM)&toolInfo);
    return hwndTip;
}

我们将TTM_ADDTOOL操作与两个HWND句柄相关联,一个是Dialogbox(hDlg),另一个是对话框中的控件。我试着发现,当鼠标悬停在toolID控件上时,注释掉toolInfo.hwnd = hDlg;仍然可以显示工具提示。

那么传递两个HWND句柄的意义是什么呢?在其他情况下,它是必须的还是有用的?

lpszText字段设置为LPSTR_TEXTCALLBACK时,也会使用TOOLINFO结构中的hwnd。当工具提示需要文本时,它将通过WM_NOTIFY消息向hwnd发送TTN_GETDISPINFO通知。然后,该消息的LPARAM将是一个指向NMTTDISPINFO结构的指针,您可以使用该结构来设置工具提示的文本。很好,以防工具提示的文本需要更改。

除了接受答案中解释的原因外,在通知hwnd时,rect成员使用该句柄后面的窗口的客户端区域作为其坐标的基础。

当未使用hwnd或它指向无效句柄时,rect成员是与屏幕相关的,这可能会导致意外行为。因此,除非你想做一些非常具体的事情来考虑桌面,否则无论何时你想使用rect,你都需要在hwnd中提供一个有效的句柄。

我找不到任何解释。我对使用这个句柄和rect成员的观察使我明白它们是以这种方式相关的。

最新更新