mensaje de TTM_GETTOOLINFO

Esta función se usa para recuperar la información que se mantiene en un control de información sobre herramientas en relación con una herramienta.

Parámetros

wParam

Debe ser cero.

lParam

Puntero a una estructura TOOLINFO . Al enviar el mensaje, los miembros hwnd y uId identifican una herramienta y el miembro cbSize debe especificar el tamaño de la estructura. Al usar este mensaje para recuperar el texto de información sobre herramientas, asegúrese de que el miembro lpszText de la estructura TOOLINFO apunta a un búfer válido de tamaño adquate.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Observaciones

Si el control de información sobre herramientas incluye la herramienta, la estructura TOOLINFO recibe información sobre la herramienta.

Ejemplos

En el ejemplo siguiente se cambia la posición de un control de información sobre herramientas.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Commctrl.h
Nombres Unicode y ANSI	TTM_GETTOOLINFOW (Unicode) y TTM_GETTOOLINFOA (ANSI)