CTooltipManager-Klasse

Verwaltet Laufzeitinformationen über QuickInfos. Die CTooltipManager -Klasse wird einmal pro Anwendung instanziiert.

Syntax

class CTooltipManager : public CObject

Member

Öffentliche Methoden

Name Beschreibung
CTooltipManager::CreateToolTip Erstellt ein QuickInfo-Steuerelement für die angegebenen Windows-Steuerelementtypen.
CTooltipManager::D eleteToolTip Löscht ein QuickInfo-Steuerelement.
CTooltipManager::SetTooltipParams Passt die visuelle Darstellung des QuickInfo-Steuerelements für die angegebenen Windows-Steuerelementtypen an.
CTooltipManager::SetTooltipText Legt den Text und die Beschreibung für ein QuickInfo-Steuerelement fest.
CTooltipManager::UpdateTooltips

Hinweise

Verwenden Sie die CMFCToolTipCtrl-KlasseCMFCToolTipInfo und CTooltipManager zusammen, um angepasste QuickInfos in Ihrer Anwendung zu implementieren. Ein Beispiel für die Verwendung dieser QuickInfo-Klassen finden Sie im Thema zur CMFCToolTipCtrl-Klasse .

Vererbungshierarchie

CObject

CTooltipManager

Anforderungen

Kopfzeile: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Erstellt ein QuickInfo-Steuerelement.

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

Parameter

pToolTip
[out] Ein Verweis auf einen QuickInfo-Zeiger. Sie wird so festgelegt, dass sie auf die neu erstellte QuickInfo zeigt, wenn die Funktion zurückgegeben wird.

pWndParent
[in] Übergeordnetes Element der QuickInfo.

nType
[in] Typ der QuickInfo.

Rückgabewert

Nonzero, wenn eine QuickInfo erfolgreich erstellt wurde.

Hinweise

Sie müssen "CTooltipManager::D eleteToolTipTip" aufrufen, um das QuickInfo-Steuerelement zu löschen, das in pToolTip zurückgegeben wird.

Der CTooltipManager legt die visuellen Anzeigeparameter jeder QuickInfo fest, die sie basierend auf dem von nType angegebenen QuickInfo-Typ erstellt. Rufen Sie CTooltipManager::SetTooltipParams auf, um die Parameter für einen oder mehrere QuickInfo-Typen zu ändern.

Gültige QuickInfo-Typen sind in der folgenden Tabelle aufgeführt:

QuickInfo-Typ Steuerelementkategorie Beispieltypen
AFX_TOOLTIP_TYPE_BUTTON Eine Schaltfläche. CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR Eine Beschriftungsleiste. CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT Jedes Steuerelement, das nicht in eine andere Kategorie passt. Keine.
AFX_TOOLTIP_TYPE_DOCKBAR Ein andockbarer Bereich. CDockablePane
AFX_TOOLTIP_TYPE_EDIT Ein Textfeld. Keine.
AFX_TOOLTIP_TYPE_MINIFRAME Ein Miniframe. CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER Ein Planer. Keine.
AFX_TOOLTIP_TYPE_RIBBON Eine Menübandleiste. CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB Ein Registerkartensteuerelement. CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR Eine Symbolleiste. CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX Eine Toolbox. Keine.

CTooltipManager::D eleteToolTip

Löscht ein QuickInfo-Steuerelement.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Parameter

pToolTip
[in, out] Ein Verweis auf einen Zeiger auf eine QuickInfo, die zerstört werden soll.

Hinweise

Rufen Sie diese Methode für jede CToolTipCtrl-Klasse auf, die von CTooltipManager::CreateToolTip erstellt wurde. Das übergeordnete Steuerelement sollte diese Methode aus dem OnDestroy Handler aufrufen. Dies ist erforderlich, um die QuickInfo ordnungsgemäß aus dem Framework zu entfernen. Diese Methode legt pToolTip auf NULL fest, bevor sie zurückgegeben wird.

CTooltipManager::SetTooltipParams

Passt die Darstellung des QuickInfo-Steuerelements für die angegebenen Windows-Steuerelementtypen an.

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

Parameter

nTypes
[in] Gibt Steuerelementtypen an.

pRTC
[in] Laufzeitklasse von benutzerdefinierten QuickInfos.

pParams
[in] QuickInfo-Parameter.

Hinweise

Diese Methode legt die Laufzeitklasse und die anfänglichen Parameter fest, die vom CToolTipManager beim Erstellen von QuickInfos verwendet werden. Wenn ein Steuerelement CTooltipManager::CreateToolTip aufruft und einen QuickInfo-Typ übergibt, der eines der von nTypes angegebenen Typen ist, erstellt der QuickInfo-Manager ein QuickInfo-Steuerelement, das eine Instanz der von pRTC angegebenen Laufzeitklasse ist, und übergibt die von pParams angegebenen Parameter an die neue QuickInfo.

Wenn Sie diese Methode aufrufen, erhalten alle vorhandenen QuickInfo-Besitzer die AFX_WM_UPDATETOOLTIPS Nachricht und müssen ihre QuickInfos mithilfe von CTooltipManager::CreateToolTipTip erneut erstellen.

nTypes können eine beliebige Kombination der gültigen QuickInfo-Typen sein, die CTooltipManager::CreateToolTip verwendet, oder es kann AFX_TOOLTIP_TYPE_ALL werden. Wenn Sie AFX_TOOLTIP_TYPE_ALL übergeben, sind alle QuickInfo-Typen betroffen.

Beispiel

Im folgenden Beispiel wird die Verwendung der SetTooltipParams Methode der CTooltipManager Klasse veranschaulicht. Dieser Codeausschnitt ist Teil des Draw Client-Beispiels.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

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

CTooltipManager::SetTooltipText

Legt den Text und die Beschreibung für eine QuickInfo fest.

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

Parameter

Pti
[in] Ein Zeiger auf ein TOOLINFO-Objekt.

pToolTip
[in, out] Ein Zeiger auf das QuickInfo-Steuerelement, für das der Text und die Beschreibung festgelegt werden sollen.

nType
[in] Gibt den Typ des Steuerelements an, dem diese QuickInfo zugeordnet ist.

strText
[in] Der Text, der als QuickInfo-Text festgelegt werden soll.

lpszDescr
[in] Ein Zeiger auf die QuickInfo-Beschreibung. Kann den Wert NULL haben.

Hinweise

Der Wert von nType muss derselbe Wert wie der nType-Parameter von CTooltipManager::CreateToolTip sein, wenn Sie die QuickInfo erstellt haben.

CTooltipManager::UpdateTooltips

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

void UpdateTooltips();

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CMFCToolTipCtrl-Klasse
CMFCToolTipInfo-Klasse