CMFCToolTipCtrl 類別

發行項
02/28/2013

根據 CToolTipCtrl 類別擴充之工具提示的實作。根據 CMFCToolTipCtrl 類別的工具提示會顯示圖示、標籤和描述。使用漸層填滿，您可以自訂其視覺外觀、自訂文字和框線色彩、粗體文字、圓角或汽球樣式。

class CMFCToolTipCtrl : public CToolTipCtrl

Members

公用建構函式

名稱	描述
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);