TTM_GETTOOLINFO Nachricht

Artikel
06/13/2023

Ruft die Informationen ab, die ein QuickInfo-Steuerelement zu einem Tool verwaltet.

Parameter

wParam: Muss Null sein.
lParam: Zeiger auf eine TOOLINFO-Struktur . Beim Senden der Nachricht identifizieren die hwnd- und uId-Member ein Tool, und der cbSize-Member muss die Größe der Struktur angeben. Wenn Sie diese Nachricht verwenden, um den QuickInfo-Text abzurufen, stellen Sie sicher, dass das lpszText-Element der TOOLINFO-Struktur auf einen gültigen Puffer mit adquate-Größe verweist.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE .

Bemerkungen

Wenn das QuickInfo-Steuerelement das Tool enthält, empfängt die TOOLINFO-Struktur Informationen über das Tool.

Beispiele

Im folgenden Beispiel wird ein QuickInfo-Steuerelement neu positioniert.

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;  
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h
Unicode- und ANSI-Name	TTM_GETTOOLINFOW (Unicode) und TTM_GETTOOLINFOA (ANSI)

Freigeben über