CMFCToolTipCtrl – třída

Poznámka:

Knihovna MFC (Microsoft Foundation Classes) se nadále podporuje. Už ale nepřidáme funkce ani aktualizujeme dokumentaci.

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

Název	Popis
`CMFCToolTipCtrl::CMFCToolTipCtrl`	Výchozí konstruktor.

Veřejné metody

Název	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();

Návratová hodnota

Velikost ikony v pixelech

CMFCToolTipCtrl::GetParams

Vrátí nastavení zobrazení popisu.

const CMFCToolTipInfo& GetParams() const;

Návratová 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

Návratová 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

Návratová 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.

Návratová 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

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-11-07

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

Návratová hodnota

CMFCToolTipCtrl::GetParams

Návratová hodnota

CMFCToolTipCtrl::OnDrawBorder

Parametry

Poznámky

CMFCToolTipCtrl::OnDrawDescription

Parametry

Návratová hodnota

Poznámky

CMFCToolTipCtrl::OnDrawicon

Parametry

Návratová hodnota

Poznámky

CMFCToolTipCtrl::OnDrawLabel

Parametry

Návratová 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

Další materiály