CTooltipManager-Klasse

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

Syntax

class CTooltipManager : public CObject

Member

Öffentliche Methoden

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:

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