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


CToolTipCtrl::AddTool

Регистрирует средство с элементом управления всплывающей подсказки.

BOOL AddTool( 
   CWnd* pWnd, 
   UINT nIDText, 
   LPCRECT lpRectTool = NULL, 
   UINT_PTR nIDTool = 0  
); 
BOOL AddTool( 
   CWnd* pWnd, 
   LPCTSTR lpszText = LPSTR_TEXTCALLBACK, 
   LPCRECT lpRectTool = NULL, 
   UINT_PTR nIDTool = 0  
);

Параметры

  • pWnd
    Указатель на окно, содержащее средство.

  • nIDText
    Идентификатор ресурса строки, содержащий текст для инструмента.

  • lpRectTool
    Указатель на структуру RECT, содержащий координаты ограничивающего прямоугольника средства. Координаты относительно верхнего левого угла клиентской области окна верхн- указанного pWnd.

  • nIDTool
    Идентификатор средства.

  • lpszText
    Указатель на текст для инструмента. Если данный параметр содержит значение LPSTR_TEXTCALLBACK, сообщения уведомлений TTN_NEEDTEXT становятся к родительскому элементу окна, которое указывает на pWnd.

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

Ненулевой, если успешно; в противном случае – значение 0.

Заметки

Параметры lpRectTool и nIDTool должны быть допустимыми или если lpRectTool равно null, то nIDTool должно быть равно 0.

Элемент управления всплывающей подсказки может быть связан с более чем одним средством. Эта функция вызывается, чтобы зарегистрировать средство с элементом управления всплывающей подсказки, так что будет отображаться сведения, хранящиеся в совете средства, когда курсор в средстве.

Примечание

Невозможно задать всплывающую подсказку статическому элементу управления с помощью AddTool.

Пример

См. пример для CPropertySheet::GetTabControl.

Требования

Header: afxcmn.h

См. также

Ссылки

Класс CToolTipCtrl

Диаграмма иерархии

CToolTipCtrl::DelTool