Compartilhar via


TTM_GETTOOLINFO mensagem

Recupera as informações que um controle de dica da ferramenta mantém sobre uma ferramenta.

Parâmetros

wParam

Deve ser zero.

lParam

Ponteiro para uma estrutura TOOLINFO . Ao enviar a mensagem, os membros hwnd e uId identificam uma ferramenta e o membro cbSize deve especificar o tamanho da estrutura. Ao usar essa mensagem para recuperar o texto da dica de ferramenta, verifique se o membro lpszText da estrutura TOOLINFO aponta para um buffer válido de tamanho adquate

Valor retornado

Retorna TRUE se tiver êxito ou FALSE caso contrário.

Comentários

Se o controle de dica de ferramenta incluir a ferramenta, a estrutura TOOLINFO receberá informações sobre a ferramenta.

Exemplos

O exemplo a seguir reposiciona um controle de dica de ferramenta.

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 Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h
Nomes Unicode e ANSI
TTM_GETTOOLINFOW (Unicode) e TTM_GETTOOLINFOA (ANSI)