CTooltipManager-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Onderhoudt runtime-informatie over knopinfo. De CTooltipManager klasse wordt één keer geïnstantieerd per toepassing.

Syntaxis

class CTooltipManager : public CObject

Leden

Openbare methoden

Naam	Description
CTooltipManager::CreateToolTip	Hiermee maakt u een besturingselement voor knopinfo voor de opgegeven Typen Windows-besturingselementen.
CTooltipManager::D eleteToolTip	Hiermee verwijdert u een besturingselement voor knopinfo.
CTooltipManager::SetTooltipParams	Hiermee past u het uiterlijk van het besturingselement voor knopinfo voor de opgegeven Typen Windows-besturingselementen aan.
CTooltipManager::SetTooltipText	Hiermee stelt u de tekst en beschrijving in voor een besturingselement voor knopinfo.
CTooltipManager::UpdateTooltips

Opmerkingen

Gebruik CMFCToolTipCtrl ClassCMFCToolTipInfo en CTooltipManager samen om aangepaste knopinfo in uw toepassing te implementeren. Zie het onderwerp CMFCToolTipCtrl Class voor een voorbeeld van het gebruik van deze knopinfoklassen.

Overnamehiërarchie

CObject

CTooltipManager

Requirements

Koptekst: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Hiermee maakt u een besturingselement voor knopinfo.

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

Parameterwaarden

pToolTip
[uit] Een verwijzing naar een aanwijzer voor knopinfo. Deze is zo ingesteld dat deze verwijst naar de zojuist gemaakte knopinfo wanneer de functie wordt geretourneerd.

pWndParent
[in] Bovenliggend element van de knopinfo.

nType
[in] Type knopinfo.

Retourwaarde

Niet-nul als er knopinfo is gemaakt.

Opmerkingen

U moet CTooltipManager::D eleteToolTip aanroepen om het besturingselement voor knopinfo te verwijderen dat terug wordt doorgegeven in pToolTip.

De CTooltipManager stelt de visuele weergaveparameters in van elke knopinfo die wordt gemaakt op basis van het type knopinfo dat door nType wordt opgegeven. Als u de parameters voor een of meer typen knopinfo wilt wijzigen, roept u CTooltipManager::SetTooltipParams aan.

Geldige typen knopinfo worden weergegeven in de volgende tabel:

Type knopinfo	Controlecategorie	Voorbeeldtypen
AFX_TOOLTIP_TYPE_BUTTON	Een knop.	CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR	Een bijschriftbalk.	CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT	Elk besturingselement dat niet in een andere categorie past.	Geen.
AFX_TOOLTIP_TYPE_DOCKBAR	Een beveiligbaar deelvenster.	CDockablePane
AFX_TOOLTIP_TYPE_EDIT	Een tekstvak.	Geen.
AFX_TOOLTIP_TYPE_MINIFRAME	Een miniframe.	CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER	Een planner.	Geen.
AFX_TOOLTIP_TYPE_RIBBON	Een lintbalk.	CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB	Een besturingselement voor tabbladen.	CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR	Een werkbalk.	CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX	Een werkset.	Geen.

CTooltipManager::D eleteToolTip

Hiermee verwijdert u een besturingselement voor knopinfo.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Parameterwaarden

pToolTip
[in, uit] Een verwijzing naar een aanwijzer naar een knopinfo die moet worden vernietigd.

Opmerkingen

Roep deze methode aan voor elke CToolTipCtrl-klasse die is gemaakt door CTooltipManager::CreateToolTip. Het bovenliggende besturingselement moet deze methode aanroepen vanuit de OnDestroy handler. Dit is vereist om de knopinfo correct uit het framework te verwijderen. Met deze methode wordt pToolTip ingesteld op NULL voordat deze wordt geretourneerd.

CTooltipManager::SetTooltipParams

Hiermee past u het uiterlijk van het besturingselement knopinfo voor de opgegeven Typen Windows-besturingselementen aan.

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

Parameterwaarden

nTypes
[in] Hiermee geeft u besturingstypen op.

pRTC
[in] Runtimeklasse van aangepaste knopinfo.

pParams
[in] Parameters voor knopinfo.

Opmerkingen

Met deze methode worden de runtimeklasse en de initiële parameters ingesteld die de CToolTipManager gebruikt bij het maken van knopinfo. Wanneer een besturingselement CTooltipManager aanroept::CreateToolTip en een type knopinfo doorgeeft dat een van de typen is die worden aangegeven door nTypes, maakt de tooltipbeheer een besturingselement voor knopinfo dat een exemplaar is van de runtimeklasse die is opgegeven door pRTC en de parameters die zijn opgegeven door pParams doorgegeven aan de nieuwe knopinfo.

Wanneer u deze methode aanroept, ontvangen alle bestaande eigenaren van knopinfo het AFX_WM_UPDATETOOLTIPS bericht en moeten ze hun knopinfo opnieuw maken met CTooltipManager::CreateToolTip.

nTypes kunnen elke combinatie zijn van de geldige tooltiptypen die door CTooltipManager::CreateToolTip worden gebruikt of kunnen worden AFX_TOOLTIP_TYPE_ALL. Als u AFX_TOOLTIP_TYPE_ALL doorgeeft, worden alle typen knopinfo beïnvloed.

Example

In het volgende voorbeeld ziet u hoe u de SetTooltipParams methode van de CTooltipManager klasse gebruikt. Dit codefragment maakt deel uit van het voorbeeld van de draw-client.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

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

CTooltipManager::SetTooltipText

Hiermee stelt u de tekst en beschrijving voor knopinfo in.

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

Parameterwaarden

Pti
[in] Een aanwijzer naar een TOOLINFO-object.

pToolTip
[in, uit] Een aanwijzer naar het besturingselement voor knopinfo waarvoor u de tekst en beschrijving wilt instellen.

nType
[in] Hiermee geeft u het type besturingselement waaraan deze knopinfo is gekoppeld.

strText
[in] De tekst die moet worden ingesteld als knopinfotekst.

lpszDescr
[in] Een aanwijzer naar de beschrijving van de knopinfo. Kan NULL zijn.

Opmerkingen

De waarde van nType moet dezelfde waarde zijn als de parameter nType van CTooltipManager::CreateToolTip bij het maken van de knopinfo.

CTooltipManager::UpdateTooltips

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

void UpdateTooltips();

Opmerkingen

Zie ook

Hiërarchiegrafiek
Klassen
CMFCToolTipCtrl-klasse
Klasse CMFCToolTipInfo