CMFCToolTipInfo 類別

發行項
10/12/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_clrFill clrFill 指定漸層開頭的色彩，而 CMFCToolTipInfo：：m_clrFillGradient clrFillGradient 指定漸層結尾的色彩。如果 m_clrFillGradient 為 -1，則沒有漸層。

CMFCToolTipInfo：：m_nMaxDescrWidth

指定每個工具提示中顯示的描述寬度上限。如果描述寬度超過指定的值，則會包裝文字。

int m_nMaxDescrWidth;

CMFCToolTipInfo：：m_bVislManagerTheme

指定應用程式視覺管理員是否控制所有工具提示的外觀。

BOOL m_bVislManagerTheme;

備註

如果 m_bVislManagerTheme 為 TRUE，則每個工具提示都會在應用程式出現在畫面上之前，向應用程式的視覺管理員要求新的 CMFCToolTipInfo ，並使用該物件中的值來判斷其外觀。系統會忽略 CMFCToolTipInfo 的其他成員。

CMFCToolTipInfo：：operator=

如需詳細資訊，請參閱 Visual Studio 安裝的 VC\atlmfc\src\mfc 資料夾中的原始程式碼 。

CMFCToolTipInfo& operator=(CMFCToolTipInfo& src);

共用方式為