TTM_GETTOOLINFO message

Article
06/13/2023

Récupère les informations qu’un contrôle d’info-bulle conserve sur un outil.

Paramètres

wParam: Doit être zéro.
lParam: Pointeur vers une structure TOOLINFO . Lors de l’envoi du message, les membres hwnd et uId identifient un outil, et le membre cbSize doit spécifier la taille de la structure. Lorsque vous utilisez ce message pour récupérer le texte de l’info-bulle, vérifiez que le membre lpszText de la structure TOOLINFO pointe vers une mémoire tampon valide de taille adquate

Valeur retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire.

Notes

Si le contrôle d’info-bulle inclut l’outil, la structure TOOLINFO reçoit des informations sur l’outil.

Exemples

L’exemple suivant repositionne un contrôle d’info-bulle.

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Commctrl.h
Noms Unicode et ANSI	TTM_GETTOOLINFOW (Unicode) et TTM_GETTOOLINFOA (ANSI)

Partager via