Поделиться через


сообщение TTM_GETTOOLINFO

Извлекает сведения, которые элемент управления подсказкой хранит о средстве.

Параметры

wParam

Должен равняться нулю.

lParam

Указатель на структуру TOOLINFO . При отправке сообщения элементы hwnd и uId идентифицируют инструмент, а член cbSize должен указывать размер структуры. При использовании этого сообщения для получения текста подсказки убедитесь, что элемент lpszText структуры TOOLINFO указывает на допустимый буфер размера adquate.

Возвращаемое значение

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае.

Комментарии

Если элемент управления tooltip включает средство, структура 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
Имя в кодировке Юникод и ANSI
TTM_GETTOOLINFOW (Юникод) и TTM_GETTOOLINFOA (ANSI)