CTooltipManager – třída

Udržuje informace o modulu runtime o popisech. Třída CTooltipManager se vytvoří jednou instancí pro každou aplikaci.

Syntaxe

class CTooltipManager : public CObject

Členové

Veřejné metody

Název	Popis
CTooltipManager::CreateToolTip	Vytvoří ovládací prvek popisu pro zadané typy ovládacích prvků systému Windows.
CTooltipManager::D eleteToolTip	Odstraní ovládací prvek popisu.
CTooltipManager::SetTooltipParams	Přizpůsobí vzhled vizuálu ovládacího prvku popisku pro zadané typy ovládacích prvků Systému Windows.
CTooltipManager::SetTooltipText	Nastaví text a popis ovládacího prvku popisu.
CTooltipManager::UpdateTooltips

Poznámky

Použijte CMFCToolTipCtrl – třída CMFCToolTipInfoa CTooltipManager společně implementujte vlastní popisy v aplikaci. Příklad použití těchto tříd popisů naleznete v tématu CMFCToolTipCtrl Třída .

Hierarchie dědičnosti

Objekt CObject

CTooltipManager

Požadavky

Hlavička: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Vytvoří ovládací prvek popisku.

static BOOL CreateToolTip(
    CToolTipCtrl*& pToolTip,
    CWnd* pWndParent,
    UINT nType);

Parametry

pToolTip
[ven] Odkaz na ukazatel popisu Když funkce vrátí, nastaví se tak, aby odkazovat na nově vytvořený popis.

pWndParent
[v] Nadřazený popis.

nType
[v] Typ popisu

Návratová hodnota

Nenulové, pokud byl popis vytvořen úspěšně.

Poznámky

Je nutné volat CTooltipManager::D eleteToolTip odstranit ovládací prvek popis, který je předán zpět v pToolTip.

CTooltipManager nastaví vizuální zobrazované parametry každého popisu, který vytvoří na základě typu popisu, který nType určuje. Chcete-li změnit parametry pro jeden nebo více typů popisů, zavolejte CTooltipManager::SetTooltipParams.

Platné typy popisů jsou uvedeny v následující tabulce:

Typ popisu	Kategorie ovládacího prvku	Příklady typů
AFX_TOOLTIP_TYPE_BUTTON	Tlačítko.	CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR	Řádek titulků.	CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT	Jakýkoli ovládací prvek, který neodpovídá jiné kategorii.	Nezaokrouhlovat.
AFX_TOOLTIP_TYPE_DOCKBAR	Ukotvené podokno.	CDockablePane
AFX_TOOLTIP_TYPE_EDIT	Textové pole.	Nezaokrouhlovat.
AFX_TOOLTIP_TYPE_MINIFRAME	Miniframe.	CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER	Plánovač.	Nezaokrouhlovat.
AFX_TOOLTIP_TYPE_RIBBON	Pás karet.	CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB	Ovládací prvek karta.	CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR	Panel nástrojů.	CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX	Sada nástrojů.	Nezaokrouhlovat.

CTooltipManager::D eleteToolTip

Odstraní ovládací prvek popisu.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Parametry

pToolTip
[in, out] Odkaz na ukazatel na popis, který se má zničit.

Poznámky

Volání této metody pro každou CToolTipCtrl třídy , která byla vytvořena CTooltipManager ::CreateToolTip. Nadřazený ovládací prvek by měl volat tuto metodu z jeho OnDestroy obslužné rutiny. To je nutné k správnému odebrání popisu z architektury. Tato metoda nastaví pToolTip na HODNOTU NULL před vrácením.

CTooltipManager::SetTooltipParams

Přizpůsobí vzhled ovládacího prvku popisku pro zadané typy ovládacích prvků Systému Windows.

void SetTooltipParams(
    UINT nTypes,
    CRuntimeClass* pRTC=RUNTIME_CLASS(CMFCToolTipCtrl),
    CMFCToolTipInfo* pParams=NULL);

Parametry

nTypes
[v] Určuje typy ovládacích prvků.

pRTC
[v] Třída modulu runtime vlastního popisu

pParams
[v] Parametry popisu

Poznámky

Tato metoda nastaví třídu modulu runtime a počáteční parametry, které CToolTipManager používá při vytváření popisů. Když ovládací prvek volá CTooltipManager::CreateToolTip a předává v typu popisu, který je jedním z typů označených nTypes, správce popisů vytvoří ovládací prvek popisku, který je instancí třídy runtime určené pRTC a předá parametry určené pParams do nového popisu.

Při volání této metody obdrží všichni existující vlastníci popisů AFX_WM_UPDATETOOLTIPS zprávu a musí znovu vytvořit popisy pomocí CTooltipManager::CreateToolTip.

NTypes může být libovolná kombinace platných typů popisů, které používá CTooltipManager::CreateToolTip , nebo může být AFX_TOOLTIP_TYPE_ALL. Pokud předáte AFX_TOOLTIP_TYPE_ALL, ovlivní to všechny typy popisů.

Příklad

Následující příklad ukazuje, jak použít SetTooltipParams metodu CTooltipManager třídy. Tento fragment kódu je součástí ukázky Klienta kreslení.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

theApp.GetTooltipManager()->SetTooltipParams(AFX_TOOLTIP_TYPE_ALL, RUNTIME_CLASS(CMFCToolTipCtrl), &params);

CTooltipManager::SetTooltipText

Nastaví text a popis popisu.

static void SetTooltipText(
    TOOLINFO* pTI,
    CToolTipCtrl* pToolTip,
    UINT nType,
    const CString strText,
    LPCTSTR lpszDescr=NULL);

Parametry

Pti
[v] Ukazatel na objekt TOOLINFO.

pToolTip
[in, out] Ukazatel na ovládací prvek popisu, pro který chcete nastavit text a popis.

nType
[v] Určuje typ ovládacího prvku, ke kterému je tento popis přidružený.

strText
[v] Text, který se má nastavit jako text popisu.

lpszDescr
[v] Ukazatel na popis popisu. Může mít hodnotu NULL.

Poznámky

Hodnota nType musí být stejná jako nType parametr CTooltipManager::CreateToolTip při vytváření popisu.

CTooltipManager::UpdateTooltips

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

void UpdateTooltips();

Poznámky

Viz také

Graf hierarchie
Třídy
CMFCToolTipCtrl – třída
CMFCToolTipInfo – třída