Программирование на Visual C++. Архив рассылки

Jenter Алекс

//-------------------------------------------------------------

void APIENTRY FillInToolInfo(TOOLINFO* ti, HWND hWnd, UINT nIDTool) {

 ZeroMemory(ti,sizeof(TOOLINFO));

 ti->cbSize = sizeof(TOOLINFO);

 if (!nIDTool) {

ti->hwnd = GetParent(hWnd);

ti->uFlags = TTF_IDISHWND;

ti->uId = (UINT)hWnd;

 } else {

ti->hwnd = hWnd;

ti->uFlags = 0;

ti->uId = nIDTool;

 }

}

Добавить

новую область подсказки можно функцией AddTool. Данная реализация AddTool предусматривает, что контрол hTip сам обеспечит себе получение системных сообщений о передвижении мыши от окон – носителей подсказки. Для этого при создании области выставляется флаг TTF_SUBCLASS. В этом случае совершенно отпадает необходимость в использованиии механизма TTM_RELAYEVENT. Флаг TTF_TRANSPARENT, что выводимые окна подсказки будут прозрачны для мышиных сообщений.

Существует возможность отложить установку текста подсказки на более позднее время. Для этого просто передается NULL-указатель в качестве указателя на текст подсказки. Вместо NULL в ToolTip контрол будет передано значение LPSTR_TEXTCALLBACK, говорящее контролу, что при необходимости он сможет получить текст подсказки посредством механизма нотификации (через WM_NOTIFY) посылкой TTN_GETDISPINFO (эквивалентное ему TTN_NEEDTEXT).

Кроме того AddTool предусматривает возможность ограничения чувствительной области окна (не только окна диалога, но и окна любого контрола) явно задаваемым прямоугольником (если указатель на него равен NULL, будет использована вся клиентская область окна). Однако, при добавлении области подсказки имеет значение способ идентификации области подсказки – если она основана на использовании хэндла окна в качестве идентификатора (установлен флаг TTF_IDISHWND), то чувствительной областью становится вся клиентская область окна – носителя, а координаты прямоугольника (даже если они указаны явно) будут игнорироваться. Как видно из реализации функции FillInToolInfo, это будет происходить для случаев, когда nIDTool равен нулю.

//-------------------------------------------------------------

BOOL APIENTRY AddTool(HWND hTip, HWND hWnd, RECT* pr, UINT nIDTool, LPCTSTR szText) {

 TOOLINFO ti;

 RECT r = {0,0,0,0};

 FillInToolInfo(&ti, hWnd, nIDTool);

 ti.hinst = (HINSTANCE)GetModuleHandle(NULL);

 ti.uFlags |= TTF_SUBCLASS | TTF_TRANSPARENT;

 ti.lpszText = LPSTR(szText ? szText : LPSTR_TEXTCALLBACK);

 if (!(ti.uFlags & TTF_IDISHWND)) {

if (!pr) {

pr = &r;

GetClientRect(hWnd, pr);

}

memcpy(&ti.rect, pr, sizeof(RECT));

 }

 BOOL res = SendMessage(hTip, TTM_ADDTOOL, 0, (LPARAM)&ti);

 return res;

}

После того, как область зарегистрирована, можно управлять ее текстом посредством UpdateTipText. Можно заметить, что в ней может быть использован тот же механизм обратного вызова текста подсказки, что и в AddTool. Т.е. в том случае, если указатель lpszText будет установлен в NULL, то будет задействован

механизм обратного вызова текста подсказки. А как же поступить в случае, если нужно просто прекратить вывод какой-либо одной подсказки, если установка lpszText в NULL задействует альтернативный способ? В этом случае нужно, чтобы lpszText указывал на пустую строку "".

//-------------------------------------------------------------

void APIENTRY UpdateTipText(HWND hTip, HWND hWnd, UINT nIDTool, LPCTSTR lpszText) {

 TOOLINFO ti;

 FillInToolInfo(&ti, hWnd, nIDTool);

 ti.lpszText = LPSTR(lpszText ? lpszText : LPSTR_TEXTCALLBACK);

 SendMessage(hTip, TTM_UPDATETIPTEXT, 0, (LPARAM)&ti);

}

Получить текст конкретной подсказки можно посредством GetTipText.

//-------------------------------------------------------------

void APIENTRY GetTipText(HWND hTip, HWND hWnd, UINT nIDTool, LPSTR szText) {

 TOOLINFO ti;

 if (!szText) return;

 *szText = 0;

 FillInToolInfo(&ti, hWnd, nIDTool);

 ti.lpszText = szText;

 SendMessage(hTip, TTM_GETTEXT, 0, (LPARAM)&ti);

}

Включить/выключить вывод всех подсказок, зарегистрированных данным tooltip-контролом, можно функцией EnableToolTip.

//-------------------------------------------------------------

void APIENTRY EnableToolTip(HWND hTip, BOOL activate) {

 SendMessage(hTip, TTM_ACTIVATE, activate, 0);

}

ПРИМЕЧАНИЕ

Необходимо отметить, что в данной реализации способа работы с областями подсказки имеется одно ограничение – если программист явным образом задает идентификаторы областей подсказки (флаг TTF_IDISHWND в этом случае не установлен), то механизм обратного вызова текста подсказки не работает, поскольку нотификационные сообщения обратного вызова приходят не диалогу, а окну-носителю области подсказки, которое не умеет их обрабатывать (в данной реализации).

MFC

В MFC для работы с всплывающими подсказками предназначен класс CToolTipCtrl. Рассмотрим, как им пользоваться.

Первым делом необходимо добавить объект класса CToolTipCtrl в класс диалогового окна, которое вы хотите снабдить всплывающими подсказками. Тем самым мы гарантируем, что этот объект будет существовать ровно столько, сколько сам диалог. Например:

class CMFCTipsDlg : public CDialog {

 …

protected:

 CToolTipCtrl m_tt;

 …

};

Хотя большую часть времени всплывающая подсказка не видна на экране, это обыкновенное окно, и прежде чем работать с ним, его необходимо создать и связать с уже имеющимся у нас объектом m_tt. Для этого используется функция CToolTipCtrl::Create, которая получает указатель на объект родительского окна и стиль подсказки, например:

BOOL CMFCTipsDlg::OnInitDialog {

 …

 m_tt.Create(this);