CMFCToolTipCtrl选件类

项目
03/01/2013

根据 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	使用 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 对象，设置工具提示显示的声明，并设置工具提示控件的宽度。

    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);