CMFCToolTipCtrl-klasse

Opmerking

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

Een uitgebreide tooltip-implementatie op basis van de CToolTipCtrl-klasse. Knopinfo op basis van de CMFCToolTipCtrl klasse kan een pictogram, een label en een beschrijving weergeven. U kunt het uiterlijk ervan aanpassen met behulp van een kleurovergang, aangepaste tekst- en randkleuren, vetgedrukte tekst, afgeronde hoeken of een ballonstijl.

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

Syntaxis

class CMFCToolTipCtrl : public CToolTipCtrl

Leden

Openbare constructors

Naam	Description
`CMFCToolTipCtrl::CMFCToolTipCtrl`	Standaardconstructor.

Openbare methoden

Naam	Description
CMFCToolTipCtrl::GetIconSize	Retourneert de grootte van een pictogram in knopinfo.
CMFCToolTipCtrl::GetParams	Retourneert de weergave-instellingen van knopinfo.
CMFCToolTipCtrl::OnDrawBorder	Hiermee tekent u de rand van knopinfo.
CMFCToolTipCtrl::OnDrawDescription
CMFCToolTipCtrl::OnDrawIcon	Geeft een pictogram weer in knopinfo.
CMFCToolTipCtrl::OnDrawLabel	Hiermee tekent u het label van knopinfo of berekent u de grootte van het label.
CMFCToolTipCtrl::OnDrawSeparator	Hiermee tekent u het scheidingsteken tussen het label en de beschrijving in knopinfo.
CMFCToolTipCtrl::OnFillBackground	Vult de achtergrond van de knopinfo.
CMFCToolTipCtrl::SetDescription	Hiermee stelt u de beschrijving in die moet worden weergegeven door de knopinfo.
CMFCToolTipCtrl::SetFixedWidth
CMFCToolTipCtrl::SetHotRibbonButton
CMFCToolTipCtrl::SetLocation
CMFCToolTipCtrl::SetParams	Hiermee geeft u het uiterlijk van een knopinfo op met behulp van een `CMFCToolTipInfo` object.

Opmerkingen

CMFCToolTipInfoGebruik CMFCToolTipCtrl, en CTooltipManager Class-objecten samen om aangepaste knopinfo in uw toepassing te implementeren.

Als u bijvoorbeeld knopinfo in ballonstijl wilt gebruiken, voert u de volgende stappen uit:

Gebruik de methode CWinAppEx Class om de knopinfobeheer in uw toepassing te initialiseren.

Maak een CMFCToolTipInfo structuur om de gewenste visuele stijl op te geven:

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

}

Gebruik de methode CTooltipManager::SetTooltipParams om de visuele stijl in te stellen voor alle knopinfo in de toepassing met behulp van de stijlen die in het CMFCToolTipInfo object zijn gedefinieerd:
```
theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMFCToolTipCtrl), &params);
```

U kunt ook een nieuwe klasse afleiden van CMFCToolTipCtrl het gedrag en het weergeven van knopinfo. Als u een nieuwe besturingselementklasse voor knopinfo wilt opgeven, gebruikt u de CTooltipManager::SetTooltipParams methode:

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

Als u de standaard besturingsklasse voor knopinfo wilt herstellen en het uiterlijk van de knopinfo wilt herstellen naar de standaardstatus, geeft u NULL op in de parameters runtimeklasse en infoparameters voor knopinfo van SetTooltipParams:

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

Example

In het volgende voorbeeld ziet u hoe u een CMFCToolTipCtrl object maakt, de beschrijving instelt die door de knopinfo wordt weergegeven en de breedte van het besturingselement voor knopinfo instelt.

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

Overnamehiërarchie

Requirements

Koptekst: afxtooltipctrl.h

CMFCToolTipCtrl::CMFCToolTipCtrl

CMFCToolTipCtrl(CMFCToolTipInfo* pParams = NULL);

Parameterwaarden

[in] pParams

Opmerkingen

CMFCToolTipCtrl::GetIconSize

Retourneert de grootte van een pictogram in knopinfo.

virtual CSize GetIconSize();

Retourwaarde

De grootte van het pictogram, in pixels.

CMFCToolTipCtrl::GetParams

Retourneert de weergave-instellingen van knopinfo.

const CMFCToolTipInfo& GetParams() const;

Retourwaarde

De huidige weergave-instellingen voor knopinfo, die zijn opgeslagen in een CMFCToolTipInfo Class-object .

CMFCToolTipCtrl::OnDrawBorder

Hiermee tekent u de rand van knopinfo.

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

Parameterwaarden

Pdc
[in] Aanwijzer naar een apparaatcontext.

Rect
[in] De begrenzingsrechthoek van de knopinfo.

clrLine
[in] Randkleur.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse om het uiterlijk van de rand met knopinfo aan te passen.

CMFCToolTipCtrl::OnDrawDescription

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

Parameterwaarden

[in] Pdc
[in] Rect
[in] bCalcOnly

Retourwaarde

Opmerkingen

CMFCToolTipCtrl::OnDrawIcon

Geeft een pictogram weer in knopinfo.

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

Parameterwaarden

Pdc
[in] Een aanwijzer naar een apparaatcontext.

rectImage
[in] Coördinaten van het pictogram.

Retourwaarde

WAAR als het pictogram is getekend. Anders ONWAAR.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse om een aangepast pictogram weer te geven. U moet ook CMFCToolTipCtrl::GetIconSize overschrijven om de knopinfo in te schakelen om de indeling van tekst en beschrijving correct te berekenen.

CMFCToolTipCtrl::OnDrawLabel

Hiermee tekent u het label van knopinfo of berekent u de grootte van het label.

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

Parameterwaarden

Pdc
[in] Een aanwijzer naar een apparaatcontext.

Rect
[in] Begrenzingsrechthoek van het labelgebied.

bCalcOnly
[in] Indien WAAR, wordt het label niet getekend.

Retourwaarde

Grootte van het label, in pixels.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse als u het uiterlijk van het label voor knopinfo wilt aanpassen.

CMFCToolTipCtrl::OnDrawSeparator

Hiermee tekent u het scheidingsteken tussen het label en de beschrijving in knopinfo.

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

Parameterwaarden

Pdc
[in] Een aanwijzer naar een apparaatcontext.

x1
[in] Horizontale coördinaat van het linkereinde van het scheidingsteken.

x2
[in] Horizontale coördinaat van het rechtereinde van het scheidingsteken.

Y
[in] Verticale coördinaat van het scheidingsteken.

Opmerkingen

De standaard implementatie tekent een lijn van het punt (x1, y) naar het punt (x2, y).

Overschrijf deze methode in een afgeleide klasse om het uiterlijk van het scheidingsteken aan te passen.

CMFCToolTipCtrl::OnFillBackground

Vult de achtergrond van de knopinfo.

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

Parameterwaarden

Pdc
[in] Een aanwijzer naar een apparaatcontext.

Rect
[in] Hiermee geeft u de begrenzingsrechthoek van het gebied dat moet worden ingevuld.

clrText
[in] Knopinfo voorgrondkleur.

clrLine
[in] Kleur van randen en de scheidingstekenlijn tussen label en beschrijving.

Opmerkingen

De standaardimplementatie vult de rechthoek die is opgegeven door rect met de kleur of het patroon dat is opgegeven door de meest recente aanroep naar CMFCToolTipCtrl::SetParams.

Overschrijf deze methode in een afgeleide klasse als u het uiterlijk van de knopinfo wilt aanpassen.

CMFCToolTipCtrl::SetDescription

Hiermee stelt u de beschrijving in die moet worden weergegeven door de knopinfo.

virtual void SetDescription(const CString strDesrciption);

Parameterwaarden

strDesrciption
[in] Beschrijvingstekst.

Opmerkingen

De beschrijvingstekst wordt weergegeven op de knopinfo onder het scheidingsteken.

CMFCToolTipCtrl::SetFixedWidth

void SetFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parameterwaarden

[in] nWidthRegular
[in] nWidthLargeImage

Opmerkingen

CMFCToolTipCtrl::SetHotRibbonButton

void SetHotRibbonButton(CMFCRibbonButton* pRibbonButton);

Parameterwaarden

[in] pRibbonButton

Opmerkingen

CMFCToolTipCtrl::SetLocation

void SetLocation(CPoint pt);

Parameterwaarden

[in] Pt

Opmerkingen

CMFCToolTipCtrl::SetParams

Hiermee geeft u het uiterlijk van een knopinfo op met behulp van een CMFCToolTipInfo Class-object .

void SetParams(CMFCToolTipInfo* pParams);

Parameterwaarden

pParams
[in] Wijs een CMFCToolTipInfo-klasseobject aan dat de weergaveparameters bevat.

Opmerkingen

Wanneer de knopinfo wordt weergegeven, wordt deze getekend met behulp van de kleuren en visuele stijlen die pParams specificeert. De waarde van pParams wordt opgeslagen in het beveiligde lid m_Params, dat toegankelijk is voor een afgeleide klasse die CMFCToolTipCtrl::OnDrawBorder, CMFCToolTipCtrl::OnDrawIcon, CMFCToolTipCtrl::OnDrawLabel, CMFCToolTipTipCtrl::OnDrawSeparator of CMFCToolTipCtrl::OnFillBackground gebruikt om de opgegeven weergave te behouden.

Zie ook

Hiërarchiegrafiek
Klassen
CToolTipCtrl-klasse
CTooltipManager-klasse
Klasse CMFCToolTipInfo
CWinAppEx-klasse

Feedback

Is deze pagina nuttig?

Last updated on 2026-02-23

Share via

CMFCToolTipCtrl-klasse

Syntaxis

Leden

Openbare constructors

Openbare methoden

Opmerkingen

Example

Overnamehiërarchie

Requirements

CMFCToolTipCtrl::CMFCToolTipCtrl

Parameterwaarden

Opmerkingen

CMFCToolTipCtrl::GetIconSize

Retourwaarde

CMFCToolTipCtrl::GetParams

Retourwaarde

CMFCToolTipCtrl::OnDrawBorder

Parameterwaarden

Opmerkingen

CMFCToolTipCtrl::OnDrawDescription

Parameterwaarden

Retourwaarde

Opmerkingen

CMFCToolTipCtrl::OnDrawIcon

Parameterwaarden

Retourwaarde

Opmerkingen

CMFCToolTipCtrl::OnDrawLabel

Parameterwaarden

Retourwaarde

Opmerkingen

CMFCToolTipCtrl::OnDrawSeparator

Parameterwaarden

Opmerkingen

CMFCToolTipCtrl::OnFillBackground

Parameterwaarden

Opmerkingen

CMFCToolTipCtrl::SetDescription

Parameterwaarden

Opmerkingen

CMFCToolTipCtrl::SetFixedWidth

Parameterwaarden

Opmerkingen

CMFCToolTipCtrl::SetHotRibbonButton

Parameterwaarden

Opmerkingen

CMFCToolTipCtrl::SetLocation

Parameterwaarden

Opmerkingen

CMFCToolTipCtrl::SetParams

Parameterwaarden

Opmerkingen

Zie ook

Feedback

Aanvullende resources