CWinAppEx::GetTooltipManager与CTooltipManager::SetTooltipParams与CTooltipManager::CreateToolTip

返回指向全局 CTooltipManager 对象。

CTooltipManager* GetTooltipManager();

返回值

对全局 CTooltipManager 对象的指针。

备注

如果 CTooltipManager 对象未初始化，此函数调用 CWinAppEx::InitTooltipManager，在返回之前指针。

要求

标头: afxwinappex.h

自定义工具提示控件的外观指定的Windows控件类型的。

void SetTooltipParams(   UINT nTypes,   CRuntimeClass* pRTC=RUNTIME_CLASS(CMFCToolTipCtrl),   CMFCToolTipInfo* pParams=NULL );

参数

[in] nTypes

指定控件类型。

[in] pRTC

自定义工具提示运行时选件类。

[in] pParams

工具提示参数。

备注

此方法设置 CTooltipManager选件类 使用的运行时选件类和初始参数时创建工具提示。 当控件位于 nTypes表示的一种类型的工具提示类型时调用CTooltipManager::CreateToolTip 并通过，工具提示管理器创建一 pRTC 指定的运行时选件类实例的工具提示控件并通过指定的参数 pParams 到新的工具提示。

当调用此方法时，所有现有工具提示所有者接收AFX_WM_UPDATETOOLTIPS消息使用 CTooltipManager::CreateToolTip，并且，它们必须重新创建它们的工具提示。

nTypes 可以是 CTooltipManager::CreateToolTip 使用活动工具提示类型的任意组合，也可以是AFX_TOOLTIP_TYPE_ALL。 如果通过AFX_TOOLTIP_TYPE_ALL，所有工具提示类型受到影响。

示例

下面的示例演示如何使用 CTooltipManager 选件类的 SetTooltipParams 方法。 此代码段是 绘制客户端示例的一部分。

C++

CMFCToolTipInfo params;params.m_bVislManagerTheme = TRUE;theApp.GetTooltipManager()->SetTooltipParams(AFX_TOOLTIP_TYPE_ALL, RUNTIME_CLASS(CMFCToolTipCtrl), &params);

要求

标头: afxtooltipmanager.h

创建一个工具提示控件。

static BOOL CreateToolTip(   CToolTipCtrl*& pToolTip,   CWnd* pWndParent,   UINT nType );

参数

[out] pToolTip

为工具提示指针的引用。 当函数返回时，它将指向新创建的工具提示。

[in] pWndParent

工具提示的父级。

[in] nType

工具提示的类型。

返回值

非零，如果工具提示成功创建了。

备注

必须调用 CTooltipManager::DeleteToolTip 删除在 pToolTip传递的工具提示控件。

它创建基于工具提示类型 nType 指定的 CTooltipManager选件类 设置每个工具提示的视觉显示参数。 若要更改一个或多个工具提示的类型参数，调用CTooltipManager::SetTooltipParams。

有效的工具提示类型在下表中列出:

工具提示类型

控件类

示例类型

AFX_TOOLTIP_TYPE_BUTTON

一个按钮。

CMFCButton

AFX_TOOLTIP_TYPE_CAPTIONBAR

标题栏。

CMFCCaptionBar

AFX_TOOLTIP_TYPE_DEFAULT

不适合其他类别的任何控件。

无。

AFX_TOOLTIP_TYPE_DOCKBAR

一个可停靠窗格。

CDockablePane

AFX_TOOLTIP_TYPE_EDIT

文本框。

无。

AFX_TOOLTIP_TYPE_MINIFRAME

一个袖珍框架。

CPaneFrameWnd

AFX_TOOLTIP_TYPE_PLANNER

一个计划程序。

无。

AFX_TOOLTIP_TYPE_RIBBON

功能区栏。

CMFCRibbonBar，CMFCRibbonPanelMenuBar

AFX_TOOLTIP_TYPE_TAB

选项卡控件。

CMFCTabCtrl

AFX_TOOLTIP_TYPE_TOOLBAR

一个工具栏。

CMFCToolBar，CMFCPopupMenuBar

AFX_TOOLTIP_TYPE_TOOLBOX

一工具箱。

无。

要求

标头: afxtooltipmanager.h