CMFCToolTipCtrl – třída

Článek
10/12/2023

Rozšířená implementace popisu na základě CToolTipCtrl Třídy. Popis založený na CMFCToolTipCtrl třídě může zobrazit ikonu, popisek a popis. Vzhled vizuálu můžete přizpůsobit pomocí přechodové výplně, vlastní barvy textu a ohraničení, tučného textu, zaoblené rohy nebo stylu bubliny.

Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

Syntaxe

class CMFCToolTipCtrl : public CToolTipCtrl

Členové

Veřejné konstruktory

Jméno	popis
`CMFCToolTipCtrl::CMFCToolTipCtrl`	Výchozí konstruktor.

Veřejné metody

Jméno	popis
CMFCToolTipCtrl::GetIconsize	Vrátí velikost ikony v popisu.
CMFCToolTipCtrl::GetParams	Vrátí nastavení zobrazení popisu.
CMFCToolTipCtrl::OnDrawBorder	Nakreslí ohraničení popisku.
CMFCToolTipCtrl::OnDrawDescription
CMFCToolTipCtrl::OnDrawicon	Zobrazí ikonu v popisu.
CMFCToolTipCtrl::OnDrawLabel	Nakreslí popisek popisku nebo vypočítá velikost popisku.
CMFCToolTipCtrl::OnDrawSeparator	Nakreslí oddělovač mezi popiskem a popisem v popisu.
CMFCToolTipCtrl::OnFillBackground	Vyplní pozadí popisu.
CMFCToolTipCtrl::SetDescription	Nastaví popis, který se má zobrazit pomocí popisu.
CMFCToolTipCtrl::SetFixedWidth
CMFCToolTipCtrl::SetHotRibbonButton
CMFCToolTipCtrl::SetLocation
CMFCToolTipCtrl::SetParams	Určuje vizuální vzhled popisu pomocí objektu `CMFCToolTipInfo` .

Poznámky

K implementaci přizpůsobených popisů v aplikaci použijte CMFCToolTipCtrlobjekty Třídy , CMFCToolTipInfoa CTooltipManager.

Pokud chcete například použít popisy bublinového stylu, postupujte takto:

K inicializaci správce popisů v aplikaci použijte metodu CWinAppEx Class .

Vytvořte CMFCToolTipInfo strukturu pro určení požadovaného vizuálního stylu:

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

}

Pomocí CTooltipManager::SetTooltipParams metoda nastavit vizuální styl pro všechny popisy v aplikaci pomocí stylů definovaných v objektuCMFCToolTipInfo:
```
theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMFCToolTipCtrl), &params);
```

Můžete také odvodit novou třídu z CMFCToolTipCtrl řízení chování popisů a vykreslování. Pokud chcete zadat novou třídu ovládacího prvku popisu, použijte metodu CTooltipManager::SetTooltipParams :

myApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMyToolTipCtrl))

Chcete-li obnovit výchozí třídu ovládacího prvku popisu a obnovit vzhled popisu do výchozího stavu, zadejte hodnotu NULL v parametrech informací o třídě modulu runtime a popisku SetTooltipParams:

theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    NULL,
    NULL);

Příklad

Následující příklad ukazuje, jak sestavit CMFCToolTipCtrl objekt, nastavit popis, který popis zobrazí, a nastavit šířku ovládacího prvku popis.

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

Hierarchie dědičnosti

Požadavky

Hlavička: afxtooltipctrl.h

CMFCToolTipCtrl::CMFCToolTipCtrl

CMFCToolTipCtrl(CMFCToolTipInfo* pParams = NULL);

Parametry

[v] pParams

Poznámky

CMFCToolTipCtrl::GetIconsize

Vrátí velikost ikony v popisu.

virtual CSize GetIconSize();

Vrácená hodnota

Velikost ikony v pixelech

CMFCToolTipCtrl::GetParams

Vrátí nastavení zobrazení popisu.

const CMFCToolTipInfo& GetParams() const;

Vrácená hodnota

Aktuální nastavení zobrazení popisu , které jsou uloženy v CMFCToolTipInfo Třídy objektu.

CMFCToolTipCtrl::OnDrawBorder

Nakreslí ohraničení popisku.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect rect,
    COLORREF clrLine);

Parametry

Pdc
[v] Ukazatel na kontext zařízení

Rect
[v] Ohraničující obdélník popisu

clrLine
[v] Barva ohraničení

Poznámky

Přepsat tuto metodu v odvozené třídě přizpůsobit vzhled ohraničení popisu.

CMFCToolTipCtrl::OnDrawDescription

virtual CSize OnDrawDescription(
    CDC* pDC,
    CRect rect,
    BOOL bCalcOnly);

Parametry

[v] Pdc
[v] Rect
[v] bCalcOnly

Vrácená hodnota

Poznámky

CMFCToolTipCtrl::OnDrawicon

Zobrazí ikonu v popisu.

virtual BOOL OnDrawIcon(
    CDC* pDC,
    CRect rectImage);

Parametry

Pdc
[v] Ukazatel na kontext zařízení.

rectImage
[v] Souřadnice ikony

Vrácená hodnota

TRUE, pokud byla ikona nakreslena. Jinak NEPRAVDA.

Poznámky

Přepište tuto metodu v odvozené třídě tak, aby se zobrazila vlastní ikona. Musíte také přepsat CMFCToolTipCtrl::GetIconSize , aby popis mohl správně vypočítat rozložení textu a popisu.

CMFCToolTipCtrl::OnDrawLabel

Nakreslí popisek popisku nebo vypočítá velikost popisku.

virtual CSize OnDrawLabel(
    CDC* pDC,
    CRect rect,
    BOOL bCalcOnly);

Parametry

Pdc
[v] Ukazatel na kontext zařízení.

Rect
[v] Ohraničující obdélník oblasti popisku

bCalcOnly
[v] Pokud je hodnota TRUE, popisek nebude nakreslen.

Vrácená hodnota

Velikost popisku v pixelech

Poznámky

Tuto metodu přepište v odvozené třídě, pokud chcete přizpůsobit vzhled popisku popisu.

CMFCToolTipCtrl::OnDrawSeparator

Nakreslí oddělovač mezi popiskem a popisem v popisu.

virtual void OnDrawSeparator(
    CDC* pDC,
    int x1,
    int x2,
    int y);

Parametry

Pdc
[v] Ukazatel na kontext zařízení.

x1
[v] Vodorovná souřadnice levého konce oddělovače

x2
[v] Vodorovná souřadnice pravého konce oddělovače.

Y
[v] Svislá souřadnice oddělovače

Poznámky

Výchozí implementace nakreslí čáru z bodu (x1, y) k bodu (x2, y).

Přepsat tuto metodu v odvozené třídě přizpůsobit vzhled oddělovače.

CMFCToolTipCtrl::OnFillBackground

Vyplní pozadí popisu.

virtual void OnFillBackground(
    CDC* pDC,
    CRect rect,
    COLORREF& clrText,
    COLORREF& clrLine);

Parametry

Pdc
[v] Ukazatel na kontext zařízení.

Rect
[v] Určuje ohraničující obdélník oblasti, která se má vyplnit.

clrText
[v] Barva popředí popisu

clrLine
[v] Barva ohraničení a oddělovače mezi popiskem a popisem

Poznámky

Výchozí implementace vyplní obdélník určený rect barvou nebo vzorem určeným posledním voláním CMFCToolTipCtrl::SetParams.

Tuto metodu přepište v odvozené třídě, pokud chcete přizpůsobit vzhled popisu.

CMFCToolTipCtrl::SetDescription

Nastaví popis, který se má zobrazit pomocí popisu.

virtual void SetDescription(const CString strDesrciption);

Parametry

strDesrciption
[v] Text popisu

Poznámky

Text popisu se zobrazí v popisku pod oddělovačem.

CMFCToolTipCtrl::SetFixedWidth

void SetFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parametry

[v] nWidthRegular
[v] nWidthLargeImage

Poznámky

CMFCToolTipCtrl::SetHotRibbonButton

void SetHotRibbonButton(CMFCRibbonButton* pRibbonButton);

Parametry

[v] pRibbonButton

Poznámky

CMFCToolTipCtrl::SetLocation

void SetLocation(CPoint pt);

Parametry

[v] Pt

Poznámky

CMFCToolTipCtrl::SetParams

Určuje vizuální vzhled popisu pomocí CMFCToolTipInfo Class objektu.

void SetParams(CMFCToolTipInfo* pParams);

Parametry

pParams
[v] Ukazatel na CMFCToolTipInfo Class objekt, který obsahuje zobrazované parametry.

Poznámky

Pokaždé, když se zobrazí popis, je vykreslen pomocí barev a vizuálních stylů, které pParams určuje. Hodnota pParams je uložena v chráněném členu m_Params, který je přístupný odvozenou třídou, která přepisuje CMFCToolTipCtrl::OnDrawBorder, CMFCToolTipCtrl::OnDrawIcon, CMFCToolTipCtrl::OnDrawLabel, CMFCToolTipCtrl::OnDrawSeparator nebo CMFCToolTipCtrl::OnFillBackground pro zachování zadaného vzhledu.

Viz také

Graf hierarchie
Třídy
CToolTipCtrl – třída
CTooltipManager – třída
CMFCToolTipInfo – třída
CWinAppEx – třída

Sdílet prostřednictvím

CMFCToolTipCtrl – třída

Syntaxe

Členové

Veřejné konstruktory

Veřejné metody

Poznámky

Příklad

Hierarchie dědičnosti

Požadavky

CMFCToolTipCtrl::CMFCToolTipCtrl

Parametry

Poznámky

CMFCToolTipCtrl::GetIconsize

Vrácená hodnota

CMFCToolTipCtrl::GetParams

Vrácená hodnota

CMFCToolTipCtrl::OnDrawBorder

Parametry

Poznámky

CMFCToolTipCtrl::OnDrawDescription

Parametry

Vrácená hodnota

Poznámky

CMFCToolTipCtrl::OnDrawicon

Parametry

Vrácená hodnota

Poznámky

CMFCToolTipCtrl::OnDrawLabel

Parametry

Vrácená hodnota

Poznámky

CMFCToolTipCtrl::OnDrawSeparator

Parametry

Poznámky

CMFCToolTipCtrl::OnFillBackground

Parametry

Poznámky

CMFCToolTipCtrl::SetDescription

Parametry

Poznámky

CMFCToolTipCtrl::SetFixedWidth

Parametry

Poznámky

CMFCToolTipCtrl::SetHotRibbonButton

Parametry

Poznámky

CMFCToolTipCtrl::SetLocation

Parametry

Poznámky

CMFCToolTipCtrl::SetParams

Parametry

Poznámky

Viz také

Váš názor

Váš názor

Další materiály