Класс CMFCToolTipCtrl

Статья
06/10/2015

Расширенная реализация подсказки на основе Класс CToolTipCtrl. Всплывающая подсказка, основанную на классе CMFCToolTipCtrl может отображать значок метку и описание. Можно настраивать свой внешний вид с помощью градиентной заливки, пользовательских цветов текст и границы, полужирный текст, скругленных углов или стиля всплывающее.

class CMFCToolTipCtrl : public CToolTipCtrl

Члены

Открытые конструкторы

Имя	Описание
CMFCToolTipCtrl::CMFCToolTipCtrl	Конструктор по умолчанию.

Открытые методы

Имя	Описание
CMFCToolTipCtrl::GetIconSize	Возвращает размер значка в подсказке.
CMFCToolTipCtrl::GetParams	Возвращает параметры отображения подсказки.
CMFCToolTipCtrl::OnDrawBorder	Рисует границу подсказки.
CMFCToolTipCtrl::OnDrawDescription
CMFCToolTipCtrl::OnDrawIcon	Отображает значок в подсказке.
CMFCToolTipCtrl::OnDrawLabel	Рисует метки, всплывающей подсказки и вычисляет размер маркера.
CMFCToolTipCtrl::OnDrawSeparator	Рисует разделитель между маркерами и описанием в подсказке.
CMFCToolTipCtrl::OnFillBackground	Заполняет фона всплывающей подсказки.
CMFCToolTipCtrl::SetDescription	Задает описание, которое должно отображаться всплывающая подсказка.
CMFCToolTipCtrl::SetFixedWidth
CMFCToolTipCtrl::SetHotRibbonButton
CMFCToolTipCtrl::SetLocation
CMFCToolTipCtrl::SetParams	Задает внешний вид элемента управления tooltip с помощью объекта CMFCToolTipInfo.

Заметки

Используйте CMFCToolTipCtrl, CMFCToolTipInfo и объекты Класс CTooltipManager совместно с инструментом подсказкам настроенным в приложении.

Например, для использования подсказок контекстное меню предупреждение- стиля, выполните следующие действия:

1. Используйте метод Класс CWinAppEx для инициализации диспетчера подсказки в приложении.

2. Создайте структуру CMFCToolTipInfo для определения визуальный стиль, который необходимо:

CMFCToolTipInfo params;
 params.m_bBoldLabel = FALSE;
 params.m_bDrawDescription = FALSE;
 params.m_bDrawIcon = FALSE;
 params.m_bRoundedCorners = TRUE;
 params.m_bDrawSeparator = FALSE;
 if (m_bCustomColors)
 {
  params.m_clrFill = RGB (255, 255, 255);
  params.m_clrFillGradient = RGB (228, 228, 240);
  params.m_clrText = RGB (61, 83, 80);
  params.m_clrBorder = RGB (144, 149, 168);
 }

3. Используйте метод CTooltipManager::SetTooltipParams для задания визуальным стилем для всех подсказок в приложении с использованием указанных стилей в объекте CMFCToolTipInfo:

theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMFCToolTipCtrl), &params);

Также можно создать новый класс, производный от CMFCToolTipCtrl для мониторинга расширения функциональности и отрисовку подсказки. Чтобы определить новую подсказку базовый класс, используйте метод CTooltipManager::SetTooltipParams:

myApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMyToolTipCtrl))

Для получения по умолчанию подсказка базовый класс и сбросить представления подсказки в состояние по умолчанию, укажите значение NULL в параметре среды выполнения и подсказки данных класса SetTooltipParams:

theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    NULL, NULL);

Пример

В следующем примере показано, как создать объект CMFCToolTipCtrl присвойте описание, подсказка отображает и укажите ширину элемента управления tooltip.

   CMFCToolTipInfo* params = new CMFCToolTipInfo();
    
    params->m_bBoldLabel = FALSE;
    params->m_bDrawDescription = FALSE;
    params->m_bDrawIcon = FALSE;
    params->m_bRoundedCorners = TRUE;
    params->m_bDrawSeparator = FALSE;
    params->m_clrFill = RGB (255, 255, 255);
    params->m_clrFillGradient = RGB (228, 228, 240);
    params->m_clrText = RGB (61, 83, 80);
    params->m_clrBorder = RGB (144, 149, 168);

    CMFCToolTipCtrl* tipCtrl = new CMFCToolTipCtrl(params);
    tipCtrl->SetDescription(_T("tool tip control"));
    tipCtrl->SetFixedWidth(100,150);