TTM_GETTOOLINFO訊息

擷取工具提示控制項維護工具的相關資訊。

參數

wParam

必須為零。

lParam

TO一FO結構的指標。 傳送訊息時， hwnd 和 uId 成員會識別工具， 而 cbSize 成員必須指定結構的大小。 使用此訊息來擷取工具提示文字時，請確定TOOTEFO結構的lpszText成員指向有效的 adquate 大小緩衝區

傳回值

如果成功，則傳回 TRUE ，否則傳回 FALSE 。

備註

如果工具提示控制項包含工具， TOANTSFO 結構會收到工具的相關資訊。

範例

下列範例會重新置放工具提示控制項。

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)