Megosztás a következőn keresztül:

CMFCToolTipCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

A CToolTipCtrl osztályon alapuló kiterjesztett elemleírás-implementáció. Az osztályon alapuló CMFCToolTipCtrl elemleírások ikont, címkét és leírást jeleníthetnek meg. A vizualizáció megjelenését színátmenetes kitöltéssel, egyéni szöveg- és szegélyszínekkel, félkövér szövegekkel, lekerekített sarkokkal vagy ballonstílussal szabhatja testre.

További részletekért tekintse meg a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

Szemantika

class CMFCToolTipCtrl : public CToolTipCtrl

Tagok

Nyilvános konstruktorok

Név Description
CMFCToolTipCtrl::CMFCToolTipCtrl Alapértelmezett konstruktor.

Nyilvános metódusok

Név Description
CMFCToolTipCtrl::GetIconSize Egy elemleírás ikonjának méretét adja vissza.
CMFCToolTipCtrl::GetParams Egy elemleírás megjelenítési beállításait adja vissza.
CMFCToolTipCtrl::OnDrawBorder Egy elemleírás szegélyét rajzolja meg.
CMFCToolTipCtrl::OnDrawDescription
CMFCToolTipCtrl::OnDrawIcon Ikont jelenít meg egy elemleírásban.
CMFCToolTipCtrl::OnDrawLabel Megrajzolja egy elemleírás címkéjét, vagy kiszámítja a címke méretét.
CMFCToolTipCtrl::OnDrawSeparator Elemleírásban rajzolja meg az elválasztójelet a címke és a leírás között.
CMFCToolTipCtrl::OnFillBackground Kitölti az elemleírás hátterét.
CMFCToolTipCtrl::SetDescription Beállítja az elemleírás által megjelenítendő leírást.
CMFCToolTipCtrl::SetFixedWidth
CMFCToolTipCtrl::SetHotRibbonButton
CMFCToolTipCtrl::SetLocation
CMFCToolTipCtrl::SetParams Egy elemleírás vizuális megjelenését adja meg objektum CMFCToolTipInfo használatával.

Megjegyzések

A CTooltipManagerCMFCToolTipInfoosztályobjektumok együttes használatával CMFCToolTipCtrltestre szabott elemleírásokat implementálhat az alkalmazásban.

Ha például ballonstílusú elemleírásokat szeretne használni, kövesse az alábbi lépéseket:

  1. A CWinAppEx Class metódus használatával inicializálhatja az elemleírás-kezelőt az alkalmazásban.

  2. Hozzon létre egy struktúrát CMFCToolTipInfo a kívánt vizuális stílus megadásához:

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

}

  3. Használja a CTooltipManager::SetTooltipParams metódust az alkalmazás összes elemleírásának vizuális stílusának beállításához az CMFCToolTipInfo objektumban meghatározott stílusok használatával:

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

Egy új osztályt CMFCToolTipCtrl is levezethet az elemleírások viselkedésének és megjelenítésének szabályozásához. Új elemleírás-vezérlőosztály megadásához használja a CTooltipManager::SetTooltipParams következő módszert:

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

Az alapértelmezett elemleírás-vezérlőosztály visszaállításához és az elemleírás alapértelmezett állapotának visszaállításához adja meg a NULL értéket a futtatókörnyezeti osztályban, és adja meg a következő elemleírás-információs SetTooltipParamsparamétereket:

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

Example

Az alábbi példa bemutatja, hogyan hozhat létre CMFCToolTipCtrl objektumot, hogyan állíthatja be az elemleírás által megjelenített leírást, és hogyan állíthatja be az elemleírás vezérlőelem szélességét.

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

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CToolTipCtrl

CMFCToolTipCtrl

Requirements

Fejléc: afxtooltipctrl.h

CMFCToolTipCtrl::CMFCToolTipCtrl

CMFCToolTipCtrl(CMFCToolTipInfo* pParams = NULL);

Paraméterek

[in] pParams

Megjegyzések

CMFCToolTipCtrl::GetIconSize

Egy elemleírás ikonjának méretét adja vissza.

virtual CSize GetIconSize();

Visszaadott érték

Az ikon mérete képpontban.

CMFCToolTipCtrl::GetParams

Egy elemleírás megjelenítési beállításait adja vissza.

const CMFCToolTipInfo& GetParams() const;

Visszaadott érték

A CMFCToolTipInfo osztályobjektumban tárolt aktuális elemleírás-megjelenítési beállítások.

CMFCToolTipCtrl::OnDrawBorder

Egy elemleírás szegélyét rajzolja meg.

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

Paraméterek

Pdc
[in] Mutasson egy eszközkörnyezetre.

téglalap
[in] Az elemleírás határoló téglalapja.

clrLine
[in] Szegély színe.

Megjegyzések

Felülbírálja ezt a metódust egy származtatott osztályban az elemleírásszegély megjelenésének testreszabásához.

CMFCToolTipCtrl::OnDrawDescription

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

Paraméterek

[in] Pdc
[in] rect
[in] bCalcOnly

Visszaadott érték

Megjegyzések

CMFCToolTipCtrl::OnDrawIcon

Ikont jelenít meg egy elemleírásban.

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

Paraméterek

Pdc
[in] Egy eszközkörnyezetre mutató mutató.

rectImage
[in] Az ikon koordinátái.

Visszaadott érték

IGAZ, ha az ikon meg lett rajzolva. Egyéb esetben HAMIS.

Megjegyzések

A metódus felülbírálása származtatott osztályban egyéni ikon megjelenítéséhez. Felül kell bírálnia a CMFCToolTipCtrl::GetIconSize parancsot is, hogy az elemleírás megfelelően kiszámítsa a szöveg és a leírás elrendezését.

CMFCToolTipCtrl::OnDrawLabel

Megrajzolja egy elemleírás címkéjét, vagy kiszámítja a címke méretét.

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

Paraméterek

Pdc
[in] Egy eszközkörnyezetre mutató mutató.

téglalap
[in] A címketerület határoló téglalapja.

bCalcOnly
[in] Ha IGAZ, a címke nem lesz rajzolva.

Visszaadott érték

A címke mérete képpontban.

Megjegyzések

Bírálja felül ezt a metódust egy származtatott osztályban, ha testre szeretné szabni az elemleírás címkéjének megjelenését.

CMFCToolTipCtrl::OnDrawSeparator

Elemleírásban rajzolja meg az elválasztójelet a címke és a leírás között.

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

Paraméterek

Pdc
[in] Egy eszközkörnyezetre mutató mutató.

x1
[in] Az elválasztó bal végének vízszintes koordinátája.

x2
[in] Az elválasztó jobb végének vízszintes koordinátája.

Y
[in] Az elválasztó függőleges koordinátája.

Megjegyzések

Az alapértelmezett implementáció egy vonalat rajzol a ponttól (x1, y) a pontig (x2, y).

Felülbírálja ezt a metódust egy származtatott osztályban az elválasztó megjelenésének testreszabásához.

CMFCToolTipCtrl::OnFillBackground

Kitölti az elemleírás hátterét.

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

Paraméterek

Pdc
[in] Egy eszközkörnyezetre mutató mutató.

téglalap
[in] A kitöltendő terület határoló téglalapját adja meg.

clrText
[in] Elemleírás előtérszíne.

clrLine
[in] A szegélyek színe és a felirat és a leírás közötti elválasztó vonal.

Megjegyzések

Az alapértelmezett implementáció kitölti a süllyesztés által megadott téglalapot a CMFCToolTipCtrl::SetParams legutóbbi hívása által megadott színnel vagy mintával.

Ha testre szeretné szabni az elemleírás megjelenését, bírálja felül ezt a metódust egy származtatott osztályban.

CMFCToolTipCtrl::SetDescription

Beállítja az elemleírás által megjelenítendő leírást.

virtual void SetDescription(const CString strDesrciption);

Paraméterek

strDesrciption
[in] Leírás szövege.

Megjegyzések

A leírás szövege megjelenik az elválasztó elemleírásban.

CMFCToolTipCtrl::SetFixedWidth

void SetFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Paraméterek

[in] nWidthRegular
[in] nWidthLargeImage

Megjegyzések

CMFCToolTipCtrl::SetHotRibbonButton

void SetHotRibbonButton(CMFCRibbonButton* pRibbonButton);

Paraméterek

[in] pRibbonButton

Megjegyzések

CMFCToolTipCtrl::SetLocation

void SetLocation(CPoint pt);

Paraméterek

[in] Pt

Megjegyzések

CMFCToolTipCtrl::SetParams

Egy elemleírás vizuális megjelenését adja meg CMFCToolTipInfo osztályobjektum használatával.

void SetParams(CMFCToolTipInfo* pParams);

Paraméterek

pParams
[in] Mutasson egy CMFCToolTipInfo osztályobjektumra , amely tartalmazza a megjelenítési paramétereket.

Megjegyzések

Amikor megjelenik az elemleírás, a pParams által megadott színekkel és vizuális stílusokkal rajzolja meg. A pParams értékét a védett tag m_Paramstárolja, amely a CMFCToolTipCtrl::OnDrawBorder, CMFCToolTipCtrl::OnDrawIcon, CMFCToolTipCtrl::OnDrawLabel, CMFCToolTipCtrl::OnDrawSeparator vagy CMFCToolTipCtrl::OnFillBackground a megadott megjelenés fenntartásához.

Lásd még

hierarchiadiagram
osztályok
CToolTipCtrl osztály
CTooltipManager osztály
CMFCToolTipInfo osztály
CWinAppEx osztály

  • Last updated on