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)