CMFCToolTipInfo 类

项目
10/17/2023

存储有关工具提示视觉外观的信息。

语法

class CMFCToolTipInfo

成员

公共方法

名称	描述
CMFCToolTipInfo::operator=

数据成员

名称	描述
CMFCToolTipInfo::m_bBalloonTooltip	指示工具提示是否具有气球外观的布尔变量。
CMFCToolTipInfo::m_bBoldLabel	指示工具提示标签是否以粗体显示的布尔变量。
CMFCToolTipInfo::m_bDrawDescription	指示工具提示是否包含说明的布尔变量。
CMFCToolTipInfo::m_bDrawIcon	指示工具提示是否包含图标的布尔变量。
CMFCToolTipInfo::m_bDrawSeparator	指示分隔符是否显示在工具提示标签和工具提示说明之间的布尔变量。
CMFCToolTipInfo::m_bRoundedCorners	指示工具提示是否具有圆角的布尔变量。
CMFCToolTipInfo::m_bVislManagerTheme	布尔变量，指示工具提示的外观是否应由虚拟管理器控制。（请参阅 CMFCVisualManager 类）。
CMFCToolTipInfo::m_clrBorder	工具提示边框的颜色。
CMFCToolTipInfo::m_clrFill	工具提示背景的颜色。
CMFCToolTipInfo::m_clrFillGradient	工具提示中渐变填充的颜色。
CMFCToolTipInfo::m_clrText	工具提示中的文本颜色。
CMFCToolTipInfo::m_nGradientAngle	工具提示中渐变填充的角度。
CMFCToolTipInfo::m_nMaxDescrWidth	工具提示中说明的最大可能宽度（以像素为单位）。

注解

同时使用 CMFCToolTipCtrl 类、CMFCToolTipInfo 和 CTooltipManager 类，以在应用程序中实现自定义的工具提示。有关如何使用这些工具提示类的示例，请参阅 CMFCToolTipCtrl 类主题。

示例

下面的示例演示了如何在 CMFCToolTipInfo 类中设置多个成员变量的值的方法。

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

继承层次结构

CMFCToolTipInfo

要求

标头：afxtooltipctrl.h

CMFCToolTipInfo::m_bBalloonTooltip

指定所有工具提示的显示样式。

BOOL m_bBalloonTooltip;

备注

TRUE 表示工具提示使用气球样式，FALSE 表示工具提示使用矩形样式。

CMFCToolTipInfo::m_bBoldLabel

指定工具提示文本的字体是否为粗体。

BOOL m_bBoldLabel;

备注

将此成员设置为 TRUE 可显示粗体字体的工具提示文本，设置为 FALSE 可显示非粗体字体的工具提示标签。

CMFCToolTipInfo::m_bDrawDescription

指定每个工具提示是否显示说明文本。

BOOL m_bDrawDescription;

注解

将此成员设置为 TRUE 可显示说明，设置为 FALSE 可隐藏说明。可以通过调用 CMFCToolTipCtrl::SetDescription 指定工具提示上的说明

CMFCToolTipInfo::m_bDrawIcon

指定是否所有工具提示均显示图标。

BOOL m_bDrawIcon;

注解

将此成员设置为 TRUE 可在每个工具提示上显示一个图标，设置为 FALSE 可显示没有图标的工具提示。

CMFCToolTipInfo::m_bDrawSeparator

指定每个工具提示的标签和说明之间是否有分隔符。

BOOL m_bDrawSeparator;

备注

将此成员设置为 TRUE 可在工具提示的标签和说明之间显示分隔符，设置为 FALSE 则显示没有分隔符的工具提示。

CMFCToolTipInfo::m_bRoundedCorners

指定所有工具提示是否都有圆角。

BOOL m_bRoundedCorners;

备注

将此成员设置为 TRUE 可在工具提示上显示圆角，设置为 FALSE 则在工具提示上显示矩形角。

CMFCToolTipInfo::m_clrBorder

指定所有工具提示上边框的颜色。

COLORREF m_clrBorder;

CMFCToolTipInfo::m_clrFill

指定工具提示背景的颜色。

COLORREF m_clrFill;

备注

如果 CMFCToolTipInfo::m_clrFillGradient 为 -1，则工具提示背景色为 m_clrFill。否则，m_clrFill 指定渐变的起始颜色，m_clrFillGradient 指定渐变末尾的颜色。 CMFCToolTipInfo::m_nGradientAngle 决定渐变的方向。

CMFCToolTipInfo::m_clrFillGradient

指定工具提示的渐变背景的结束颜色。

COLORREF m_clrFillGradient;

备注

如果 m_clrFillGradient 为 -1，则无渐变。否则，渐变初始颜色由 CMFCToolTipInfo::m_clrFill 指定，渐变结束颜色由 m_clrFillGradient 指定。 CMFCToolTipInfo::m_nGradientAngle 决定渐变的方向。

CMFCToolTipInfo::m_clrText

指定所有工具提示的文本颜色。

COLORREF m_clrText;

CMFCToolTipInfo::m_nGradientAngle

指定工具提示背景上渐变的绘制角度。

int m_nGradientAngle;

备注

m_nGradientAngle 指定工具提示背景上的渐变偏离水平的角度（以度为单位）。如果 m_nGradientAngle 为 0，则从左到右绘制渐变。如果 m_nGradientAngle 介于 1 到 360 之间，则渐变顺时针旋转该度数。如果 m_nGradientAngle 为 -1，即默认值，则从上到下绘制渐变。这与将 m_nGradientAngle 设置为 90 的效果相同。

CMFCToolTipInfo::m_clrFillclrFill 指定渐变开头的颜色，CMFCToolTipInfo::m_clrFillGradientclrFillGradient 指定渐变结束的颜色。如果 m_clrFillGradient 为 -1，则无渐变。

CMFCToolTipInfo::m_nMaxDescrWidth

指定每个工具提示中显示的说明的最大宽度。如果说明宽度超过指定值，文本将换行。

int m_nMaxDescrWidth;

CMFCToolTipInfo::m_bVislManagerTheme

指定应用程序视觉管理器是否控制所有工具提示的外观。

BOOL m_bVislManagerTheme;

备注

如果 m_bVislManagerTheme 为 TRUE，则每个工具提示会在工具提示在屏幕上显示之前从应用程序的视觉管理器请求新的 CMFCToolTipInfo，并使用该对象中的值来确定提示外观。将忽略 CMFCToolTipInfo 的其他成员。

CMFCToolTipInfo::operator=

有关详细信息，请参阅所安装的 Visual Studio 的 C\atlmfc\src\mfc 文件夹中的源代码。

CMFCToolTipInfo& operator=(CMFCToolTipInfo& src);

Share via