CToolTipCtrl::AddTool

Статья
02/20/2013

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

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.