TTM_GETTOOLINFO消息

检索工具提示控件维护的工具相关信息。

参数

wParam

必须为零。

lParam

指向 TOOLINFO 结构的指针。 发送消息时， hwnd 和 uId 成员标识工具， cbSize 成员必须指定结构的大小。 使用此消息检索工具提示文本时，请确保 TOOLINFO 结构的 lpszText 成员指向有效、大小为等号的缓冲区

返回值

如果成功，则返回 TRUE ，否则返回 FALSE 。

备注

如果工具提示控件包含该工具， TOOLINFO 结构将接收有关该工具的信息。

示例

以下示例重新定位工具提示控件。

HRESULT MyToolTipClass::OffsetTooltip(int xOffset, int yOffset)  
{  
    HRESULT hr = S_OK;   
    DWORD   dwError = 0;  
  
    if (NULL != m_hWndToolTip)  
    {  
        TOOLINFO ti = {0};  
  
        ti.cbSize = sizeof(TOOLINFO);  
        ti.hwnd   = m_hWndToolTipOwner;  
  
        // Get the current tooltip definition.          
        if( SendMessage(m_hWndToolTip, TTM_GETTOOLINFO, 0, (LPARAM)&ti))  
        {  
            // Offset the tooltip rectangle as specified.              
            OffsetRect(&ti.rect, xOffset, yOffset);  
  
            // Apply the new rectangle to the tooltip.
            SendMessage(m_hWndToolTip, TTM_NEWTOOLRECT, 0, (LPARAM)&ti);  
        }  
        else  
        {  
            dwError = GetLastError();  
            hr = HRESULT_FROM_WIN32(dwError);  
            MyErrorHandler(hr);
       }  
    }  
    return hr;  
}  

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	Commctrl.h
Unicode 和 ANSI 名称	TTM_GETTOOLINFOW (Unicode) 和 TTM_GETTOOLINFOA (ANSI)