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

CTooltipManager 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.

Karbantartja az elemleírásokkal kapcsolatos futásidejű információkat. Az CTooltipManager osztály példányosítása alkalmazásonként egyszer történik.

Szemantika

class CTooltipManager : public CObject

Tagok

Nyilvános metódusok

Név Description
CTooltipManager::CreateToolTip Elemleírás-vezérlőt hoz létre a megadott Windows-vezérlőtípus(ok)hoz.
CTooltipManager::D eleteToolTip Elemleírás-vezérlő törlése.
CTooltipManager::SetTooltipParams Testre szabja a megadott Windows-vezérlőtípus(ok) elemleírás-vezérlőjének vizuális megjelenését.
CTooltipManager::SetTooltipText Beállítja egy elemleírás-vezérlő szövegét és leírását.
CTooltipManager::UpdateTooltips

Megjegyzések

Használja a CMFCToolTipCtrl osztályt, CMFCToolTipInfoés CTooltipManager együtt, hogy testre szabott elemleírásokat implementáljon az alkalmazásban. Az elemleírás-osztályok használatára vonatkozó példát a CMFCToolTipCtrl osztály témakörében talál.

Öröklési hierarchia

CObject

CTooltipManager

Requirements

Fejléc: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Elemleírás-vezérlőt hoz létre.

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

Paraméterek

pToolTip
[kifelé] Elemleírás-mutatóra mutató hivatkozás. A függvény visszatérésekor az újonnan létrehozott elemleírásra van beállítva.

pWndParent
[in] Az elemleírás szülője.

nType
[in] Az elemleírás típusa.

Visszaadott érték

Nem kötelező, ha egy elemleírás sikeresen létrejött.

Megjegyzések

A CTooltipManager::D eleteToolTip parancs meghívásával törölheti a pToolTipben visszaadott elemleírás-vezérlőt.

A CTooltipManager az nType által megadott elemleírás-típus alapján állítja be az általa létrehozott elemleírások vizuális megjelenítési paramétereit. Egy vagy több elemleírás-típus paramétereinek módosításához hívja meg a CTooltipManager::SetTooltipParams parancsot.

Az érvényes elemleírás-típusok az alábbi táblázatban találhatók:

Elemleírás típusa Vezérlőkategória Példatípusok
AFX_TOOLTIP_TYPE_BUTTON Egy gomb. CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR Feliratsáv. CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT Bármely vezérlőelem, amely nem fér el egy másik kategóriához. Nincs.
AFX_TOOLTIP_TYPE_DOCKBAR Dokkolható ablaktábla. CDockablePane
AFX_TOOLTIP_TYPE_EDIT Egy szövegdoboz. Nincs.
AFX_TOOLTIP_TYPE_MINIFRAME Egy minikeret. CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER Egy tervező. Nincs.
AFX_TOOLTIP_TYPE_RIBBON Szalagsáv. CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB Tabulátor vezérlőelem. CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR Eszköztár. CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX Egy eszközkészlet. Nincs.

CTooltipManager::D eleteToolTip

Elemleírás-vezérlő törlése.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Paraméterek

pToolTip
[be, ki] A megsemmisítendő elemleírásra mutató hivatkozás.

Megjegyzések

Hívja meg ezt a metódust a CTooltipManager által létrehozott összes CToolTipCtrl-osztályhoz::CreateToolTip. A szülő vezérlőelemnek ezt a metódust a kezelőtől kell meghívnia OnDestroy . Ez szükséges az elemleírás megfelelő eltávolításához a keretrendszerből. Ez a metódus null értékre állítja a pToolTip értéket , mielőtt visszatér.

CTooltipManager::SetTooltipParams

Testre szabja az elemleírás-vezérlő megjelenését a megadott Windows-vezérlőtípusokhoz.

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

Paraméterek

nTypes
[in] Vezérlőtípusokat határoz meg.

pRTC
[in] Egyéni elemleírás futtatókörnyezeti osztálya.

pParams
[in] Elemleírási paraméterek.

Megjegyzések

Ez a metódus beállítja a futásidejű osztályt és a kezdeti paramétereket, amelyeket a CToolTipManager az elemleírások létrehozásakor használ. Amikor egy vezérlő meghívja a CTooltipManager::CreateToolTip parancsot, és olyan elemleírás-típust ad át, amely az nTypes által jelzett egyik típus, az elemleírás-kezelő létrehoz egy elemleírás-vezérlőt, amely a pRTC által megadott futtatókörnyezeti osztály egy példánya, és átadja a pParams által megadott paramétereket az új elemleírásnak.

Amikor meghívja ezt a metódust, minden meglévő elemleírás-tulajdonos megkapja a AFX_WM_UPDATETOOLTIPS üzenetet, és újra létre kell hoznia az elemleírásokat a CTooltipManager::CreateToolTip használatával.

Az nTypes a CTooltipManager::CreateToolTip által használt érvényes elemleírás-típusok bármely kombinációja lehet, vagy AFX_TOOLTIP_TYPE_ALL. Ha AFX_TOOLTIP_TYPE_ALL ad át, a rendszer minden elemleírás-típust érint.

Example

Az alábbi példa bemutatja, hogyan használható az SetTooltipParamsCTooltipManager osztály metódusa. Ez a kódrészlet a Rajz ügyfélminta része.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

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

CTooltipManager::SetTooltipText

Beállítja egy elemleírás szövegét és leírását.

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

Paraméterek

pTI
[in] Mutató egy TOOLINFO-objektumra.

pToolTip
[be, ki] Mutató arra az elemleírás-vezérlőre, amelyhez be szeretné állítani a szöveget és a leírást.

nType
[in] Azt a vezérlőtípust adja meg, amelyhez ez az elemleírás társítva van.

strText
[in] Elemleírásként beállítani kívánt szöveg.

lpszDescr
[in] Mutató az elemleírás leírására. Null érték is lehet.

Megjegyzések

Az nType értékének meg kell egyeznie a CTooltipManager::CreateToolTip paraméter nType paraméterével az elemleírás létrehozásakor.

CTooltipManager::UpdateTooltips

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.

void UpdateTooltips();

Megjegyzések

Lásd még

hierarchiadiagram
osztályok
CMFCToolTipCtrl osztály
CMFCToolTipInfo osztály

  • Last updated on