CToolTipCtrl-Klasse

Kapselt die Funktionalität eines QuickInfo-Steuerelements, einem kleinen Popupfenster, in dem eine einzelne Textzeile angezeigt wird, die den Zweck eines Tools in einer Anwendung beschreibt.

Syntax

class CToolTipCtrl : public CWnd

Member

Öffentliche Konstruktoren

Name	Beschreibung
CToolTipCtrl::CToolTipCtrl	Erstellt ein CToolTipCtrl-Objekt.

Öffentliche Methoden

Name	Beschreibung
CToolTipCtrl::Activate	Aktiviert und deaktiviert das QuickInfo-Steuerelement.
CToolTipCtrl::AddTool	Registriert ein Tool mit dem QuickInfo-Steuerelement.
CToolTipCtrl::AdjustRect	Konvertiert zwischen dem Textanzeigerechteck eines QuickInfo-Steuerelements und dem zugehörigen Fensterrechteck.
CToolTipCtrl::Create	Erstellt ein QuickInfo-Steuerelement und fügt es an ein CToolTipCtrl Objekt an.
CToolTipCtrl::CreateEx	Erstellt ein QuickInfo-Steuerelement mit den angegebenen erweiterten Windows-Formatvorlagen und fügt es an ein CToolTipCtrl Objekt an.
CToolTipCtrl::DelTool	Entfernt ein Tool aus dem QuickInfo-Steuerelement.
CToolTipCtrl::GetBubbleSize	Ruft die Größe der QuickInfo ab.
CToolTipCtrl::GetCurrentTool	Ruft Informationen wie Größe, Position und Text des QuickInfo-Fensters ab, das vom aktuellen QuickInfo-Steuerelement angezeigt wird.
CToolTipCtrl::GetDelayTime	Ruft die anfänglichen, Popup- und Anzeigedauern ab, die derzeit für ein QuickInfo-Steuerelement festgelegt sind.
CToolTipCtrl::GetMargin	Ruft die oberen, linken, unteren und rechten Seitenränder ab, die für ein QuickInfo-Fenster festgelegt sind.
CToolTipCtrl::GetMaxTipWidth	Ruft die maximale Breite für ein QuickInfo-Fenster ab.
CToolTipCtrl::GetText	Ruft den Text ab, den ein QuickInfo-Steuerelement für ein Tool verwaltet.
CToolTipCtrl::GetTipBkColor	Ruft die Hintergrundfarbe in einem QuickInfo-Fenster ab.
CToolTipCtrl::GetTipTextColor	Ruft die Textfarbe in einem QuickInfo-Fenster ab.
CToolTipCtrl::GetTitle	Ruft den Titel des aktuellen QuickInfo-Steuerelements ab.
CToolTipCtrl::GetToolCount	Ruft die Anzahl der Tools ab, die von einem QuickInfo-Steuerelement verwaltet werden.
CToolTipCtrl::GetToolInfo	Ruft die Informationen ab, die ein QuickInfo-Steuerelement über ein Tool verwaltet.
CToolTipCtrl::HitTest	Testet einen Punkt, um festzustellen, ob es sich innerhalb des umgebenden Rechtecks des angegebenen Tools befindet. Wenn ja, werden Informationen zum Tool abgerufen.
CToolTipCtrl::Pop	Entfernt ein angezeigtes QuickInfo-Fenster aus der Ansicht.
CToolTipCtrl::Popup	Bewirkt, dass das aktuelle QuickInfo-Steuerelement an den Koordinaten der letzten Mausnachricht angezeigt wird.
CToolTipCtrl::RelayEvent	Übergibt eine Mausnachricht an ein QuickInfo-Steuerelement zur Verarbeitung.
CToolTipCtrl::SetDelayTime	Hiermit wird die anfängliche Anzeigedauer, die Anzeigedauer von Popupelementen und die Dauer für erneutes Anzeigen für QuickInfo-Steuerelemente festgelegt.
CToolTipCtrl::SetMargin	Legt die oberen, linken, unteren und rechten Seitenränder für ein QuickInfo-Fenster fest.
CToolTipCtrl::SetMaxTipWidth	Legt die maximale Breite für ein QuickInfo-Fenster fest.
CToolTipCtrl::SetTipBkColor	Legt die Hintergrundfarbe in einem QuickInfo-Fenster fest.
CToolTipCtrl::SetTipTextColor	Legt die Textfarbe in einem QuickInfo-Fenster fest.
CToolTipCtrl::SetTitle	Fügt einer QuickInfo ein Standardsymbol und eine Titelzeichenfolge hinzu.
CToolTipCtrl::SetToolInfo	Legt die Informationen fest, die eine QuickInfo für ein Tool verwaltet.
CToolTipCtrl::SetToolRect	Legt ein neues umgebendes Rechteck für ein Tool fest.
CToolTipCtrl::SetWindowTheme	Legt die visuelle Formatvorlage des QuickInfo-Fensters fest.
CToolTipCtrl::Update	Erzwingt, dass das aktuelle Tool neu gezeichnet wird.
CToolTipCtrl::UpdateTipText	Legt den QuickInfo-Text für ein Tool fest.

Hinweise

Ein "Tool" ist entweder ein Fenster, z. B. ein untergeordnetes Fenster oder Steuerelement, oder ein anwendungsdefinierter rechteckiger Bereich innerhalb des Clientbereichs eines Fensters. Eine QuickInfo ist meistens ausgeblendet, wird nur angezeigt, wenn der Benutzer den Cursor auf ein Tool setzt und ihn für ungefähr eine halbe Sekunde dort belässt. Die QuickInfo wird in der Nähe des Cursors angezeigt und verschwindet, wenn der Benutzer auf eine Maustaste klickt oder den Cursor aus dem Tool verschiebt.

CToolTipCtrl stellt die Funktionalität bereit, um die anfängliche Zeit und Dauer der QuickInfo, die Randbreite um den QuickInfo-Text, die Breite des QuickInfo-Fensters selbst und die Hintergrund- und Textfarbe der QuickInfo zu steuern. Ein einzelnes QuickInfo-Steuerelement kann Informationen für mehrere Tools bereitstellen.

Die CToolTipCtrl Klasse stellt die Funktionalität des allgemeinen Windows-QuickInfo-Steuerelements bereit. Dieses Steuerelement (und daher die Klasse) ist nur für Programme verfügbar, die CToolTipCtrl unter Windows 95/98 und Windows NT,3.51 und höher ausgeführt werden.

Weitere Informationen zum Aktivieren von QuickInfos finden Sie unter Tooltipps in Windows, die nicht von CFrameWndabgeleitet werden.

Weitere Informationen zur Verwendung CToolTipCtrlfinden Sie unter "Steuerelemente und Verwenden" CToolTipCtrl.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CToolTipCtrl

Anforderungen

Header: afxcmn.h

CToolTipCtrl::Activate

Rufen Sie diese Funktion auf, um ein QuickInfo-Steuerelement zu aktivieren oder zu deaktivieren.

void Activate(BOOL bActivate);

Parameter

bActivate
Gibt an, ob das QuickInfo-Steuerelement aktiviert oder deaktiviert werden soll.

Hinweise

Ist bActivate dies der Fall, wird TRUEdas Steuerelement aktiviert; wenn FALSE, wird es deaktiviert.

Wenn ein QuickInfo-Steuerelement aktiv ist, werden die QuickInfo-Informationen angezeigt, wenn sich der Cursor auf einem Tool befindet, das beim Steuerelement registriert ist. Wenn sie inaktiv ist, werden die QuickInfo-Informationen nicht angezeigt, auch wenn sich der Cursor auf einem Tool befindet.

Beispiel

Ein Beispiel hierfür finden Sie unter CPropertySheet::GetTabControl.

CToolTipCtrl::AddTool

Registriert ein Tool mit dem QuickInfo-Steuerelement.

BOOL AddTool(
    CWnd* pWnd,
    UINT nIDText,
    LPCRECT lpRectTool = NULL,
    UINT_PTR nIDTool = 0);

BOOL AddTool(
    CWnd* pWnd,
    LPCTSTR lpszText = LPSTR_TEXTCALLBACK,
    LPCRECT lpRectTool = NULL,
    UINT_PTR nIDTool = 0);

Parameter

pWnd
Zeigen Sie auf das Fenster, das das Tool enthält.

nIDText
ID der Zeichenfolgenressource, die den Text für das Tool enthält.

lpRectTool
Zeigen Sie auf eine RECT Struktur, die Koordinaten des umgebenden Rechtecks des Tools enthält. Die Koordinaten sind relativ zur oberen linken Ecke des Clientbereichs des durch identifizierten pWndFensters.

nIDTool
ID des Tools.

lpszText
Zeigen Sie auf den Text für das Tool. Wenn dieser Parameter den Wert LPSTR_TEXTCALLBACKenthält, TTN_NEEDTEXT wechseln Benachrichtigungen zum übergeordneten Fenster des Fensters, auf das pWnd verweist.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Die lpRectTool Parameter nIDTool müssen beide gültig sein, oder wenn lpRectTool dies der Wert ist NULL, nIDTool muss 0 sein.

Ein QuickInfo-Steuerelement kann mehreren Tools zugeordnet werden. Rufen Sie diese Funktion auf, um ein Tool mit dem QuickInfo-Steuerelement zu registrieren, damit die in der QuickInfo gespeicherten Informationen angezeigt werden, wenn sich der Cursor auf dem Tool befindet.

Hinweis

Sie können eine QuickInfo nicht mithilfe AddTooleines statischen Steuerelements festlegen.

Beispiel

Ein Beispiel hierfür finden Sie unter CPropertySheet::GetTabControl.

CToolTipCtrl::AdjustRect

Konvertiert zwischen dem Textanzeigerechteck eines QuickInfo-Steuerelements und dem zugehörigen Fensterrechteck.

BOOL AdjustRect(
    LPRECT lprc,
    BOOL bLarger = TRUE);

Parameter

lprc
Zeigen Sie auf eine RECT Struktur, die entweder ein QuickInfo-Fensterrechteck oder ein Textanzeigerechteck enthält.

bLarger
Wird TRUEverwendet, lprc um ein Textanzeigerechteck anzugeben und erhält das entsprechende Fensterrechteck. Wenn FALSE, lprc wird verwendet, um ein Fensterrechteck anzugeben, und es empfängt das entsprechende Textanzeigerechteck.

Rückgabewert

Nonzero, wenn das Rechteck erfolgreich angepasst wird; andernfalls 0.

Hinweise

Diese Memberfunktion berechnet das Textanzeigerechteck eines QuickInfo-Steuerelements aus dem Fensterrechteck oder das QuickInfo-Fensterrechteck, das zum Anzeigen eines angegebenen Textanzeigerechtecks erforderlich ist.

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_ADJUSTRECT, wie im Windows SDK beschrieben.

CToolTipCtrl::Create

Erstellt ein QuickInfo-Steuerelement und fügt es an ein CToolTipCtrl Objekt an.

virtual BOOL Create(CWnd* pParentWnd, DWORD dwStyle = 0);

Parameter

pParentWnd
Gibt das übergeordnete Fenster des QuickInfo-Steuerelements an, in der Regel ein CDialog. Es darf nicht sein NULL.

dwStyle
Gibt die Formatvorlage des QuickInfo-Steuerelements an. Weitere Informationen finden Sie im Abschnitt Bemerkungen.

Rückgabewert

Nonzero, wenn das CToolTipCtrl Objekt erfolgreich erstellt wurde; andernfalls 0.

Hinweise

Sie erstellen eine CToolTipCtrl in zwei Schritten. Rufen Sie zuerst den Konstruktor auf, um das CToolTipCtrl Objekt zu erstellen, und rufen Create Sie dann auf, um das QuickInfo-Steuerelement zu erstellen und es an das CToolTipCtrl Objekt anzufügen.

Der dwStyle Parameter kann eine beliebige Kombination aus Fensterformatvorlagen sein. Darüber hinaus verfügt ein QuickInfo-Steuerelement über zwei klassenspezifische Stile: TTS_ALWAYSTIP und TTS_NOPREFIX.

Stil	Bedeutung
TTS_ALWAYSTIP	Gibt an, dass die QuickInfo angezeigt wird, wenn sich der Cursor auf einem Tool befindet, unabhängig davon, ob das Besitzerfenster des QuickInfo-Steuerelements aktiv oder inaktiv ist. Ohne diese Formatvorlage wird das QuickInfo-Steuerelement angezeigt, wenn das Besitzerfenster des Tools aktiv ist, aber nicht, wenn es inaktiv ist.
TTS_NOPREFIX	Diese Formatvorlage verhindert, dass das System das kaufmännische Und-Zeichen (&) aus einer Zeichenfolge entfernt. Wenn ein QuickInfo-Steuerelement nicht über die TTS_NOPREFIX Formatvorlage verfügt, entfernt das System automatisch kaufmännische Und-Zeichen, sodass eine Anwendung dieselbe Zeichenfolge wie ein Menüelement und text in einem QuickInfo-Steuerelement verwenden kann.

Ein QuickInfo-Steuerelement weist die WS_POPUP Formatvorlagen und WS_EX_TOOLWINDOW Fensterformatvorlagen auf, unabhängig davon, ob Sie sie beim Erstellen des Steuerelements angeben.

Um ein QuickInfo-Steuerelement mit erweiterten Fensterformaten zu erstellen, rufen Sie CToolTipCtrl::CreateEx anstelle von Create.

Beispiel

Ein Beispiel hierfür finden Sie unter CPropertySheet::GetTabControl.

CToolTipCtrl::CreateEx

Erstellt ein Steuerelement (ein untergeordnetes Fenster) und ordnet es dem Objekt zu CToolTipCtrl .

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwStyle = 0,
    DWORD dwStyleEx = 0);

Parameter

pParentWnd
Ein Zeiger auf das Fenster, das das übergeordnete Steuerelement ist.

dwStyle
Gibt die Formatvorlage des QuickInfo-Steuerelements an. Weitere Informationen finden Sie im Abschnitt Create "Hinweise".

dwStyleEx
Gibt die erweiterte Formatvorlage des zu erstellenden Steuerelements an. Eine Liste der erweiterten Windows-Stile finden Sie im dwExStyle Parameter für CreateWindowEx das Windows SDK.

Rückgabewert

Nonzero bei erfolgreicher Ausführung andernfalls 0.

Hinweise

Verwenden Sie CreateEx anstelle von Create erweiterten Windows-Formatvorlagen, die durch die Erweiterte Formatvorlage WS_EX_von Windows angegeben werden.

CToolTipCtrl::CToolTipCtrl

Erstellt ein CToolTipCtrl-Objekt.

CToolTipCtrl();

Hinweise

Sie müssen nach dem Erstellen des Objekts aufrufen Create .

Beispiel

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

Entfernt das durch pWnd und nIDTool aus der Sammlung von Tools, die von einem QuickInfo-Steuerelement unterstützt werden.

void DelTool(
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

Parameter

pWnd
Zeigen Sie auf das Fenster, das das Tool enthält.

nIDTool
ID des Tools.

CToolTipCtrl::GetBubbleSize

Ruft die Größe der QuickInfo ab.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

Parameter

lpToolInfo
Ein Zeiger auf die Struktur der TOOLINFO QuickInfo.

Rückgabewert

Die Größe der QuickInfo.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_GETBUBBLESIZE, wie im Windows SDK beschrieben.

CToolTipCtrl::GetCurrentTool

Ruft Informationen wie Größe, Position und Text des QuickInfo-Fensters ab, das vom aktuellen QuickInfo-Steuerelement angezeigt wird.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

Parameter

lpToolInfo
[out] Zeigen Sie auf eine TOOLINFO Struktur, die Informationen zum aktuellen QuickInfo-Fenster empfängt.

Rückgabewert

TRUEwenn die Informationen erfolgreich abgerufen werden; andernfalls . FALSE

Hinweise

Diese Methode sendet die TTM_GETCURRENTTOOL Nachricht, die im Windows SDK beschrieben wird.

Beispiel

Im folgenden Codebeispiel werden Informationen zum aktuellen QuickInfo-Fenster abgerufen.

{
    //Get information about the current tooltip. 
    TOOLINFO tInfo = {0};
    tInfo.cbSize = sizeof(TOOLINFO);
    CToolBarCtrl& m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
    CToolTipCtrl* m_toolTip = m_toolBarCtrl.GetToolTips();
    BOOL bRet = m_toolTip->GetCurrentTool( &tInfo );
}

CToolTipCtrl::GetDelayTime

Ruft die anfänglichen, Popup- und Anzeigedauern ab, die derzeit für ein QuickInfo-Steuerelement festgelegt sind.

int GetDelayTime(DWORD dwDuration) const;

Parameter

dwDuration
Flag, das angibt, welcher Dauerwert abgerufen wird. Dieser Parameter kann einen der folgenden -Werte aufweisen:

• TTDT_AUTOPOP Rufen Sie die Zeitspanne ab, die das QuickInfo-Fenster sichtbar bleibt, wenn der Zeiger innerhalb des umgebenden Rechtecks eines Tools steht.

• TTDT_INITIAL Rufen Sie die Dauer ab, die der Zeiger innerhalb des umgebenden Rechtecks eines Tools verbleiben muss, bevor das QuickInfo-Fenster angezeigt wird.

• TTDT_RESHOW Rufen Sie die Zeitspanne ab, die für nachfolgende QuickInfo-Fenster benötigt wird, wenn der Zeiger von einem Tool zu einem anderen wechselt.

Rückgabewert

Die angegebene Verzögerungszeit in Millisekunden

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_GETDELAYTIME, wie im Windows SDK beschrieben.

CToolTipCtrl::GetMargin

Ruft die oberen, linken, unteren und rechten Seitenränder für ein QuickInfo-Fenster ab.

void GetMargin(LPRECT lprc) const;

Parameter

lprc
Adresse einer RECT Struktur, die die Randinformationen empfängt. Die Elemente der RECT Struktur definieren kein umgebendes Rechteck. Für die Zwecke dieser Nachricht werden die Strukturmmber wie folgt interpretiert:

Member	Darstellung
top	Abstand zwischen dem oberen Rahmen und dem oberen Rand des QuickInfo-Texts in Pixel.
left	Abstand zwischen dem linken Rahmen und dem linken Ende des Tipptexts in Pixel.
bottom	Abstand zwischen dem unteren Rahmen und dem unteren Rand des Tipptexts in Pixel.
right	Abstand zwischen dem rechten Rahmen und dem rechten Ende des Tipptexts in Pixel.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_GETMARGIN, wie im Windows SDK beschrieben.

CToolTipCtrl::GetMaxTipWidth

Ruft die maximale Breite für ein QuickInfo-Fenster ab.

int GetMaxTipWidth() const;

Rückgabewert

Die maximale Breite für ein QuickInfo-Fenster.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_GETMAXTIPWIDTH, wie im Windows SDK beschrieben.

CToolTipCtrl::GetText

Ruft den Text ab, den ein QuickInfo-Steuerelement für ein Tool verwaltet.

void GetText(
    CString& str,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

Parameter

str
Verweisen auf ein CString Objekt, das den Text des Tools empfängt.

pWnd
Zeigen Sie auf das Fenster, das das Tool enthält.

nIDTool
ID des Tools.

Hinweise

Die pWnd Parameter nIDTool identifizieren das Tool. Wenn dieses Tool zuvor mit dem QuickInfo-Steuerelement über einen vorherigen Aufruf CToolTipCtrl::AddToolregistriert wurde, wird dem Objekt, auf das durch den str Parameter verwiesen wird, der Text des Tools zugewiesen.

CToolTipCtrl::GetTipBkColor

Ruft die Hintergrundfarbe in einem QuickInfo-Fenster ab.

COLORREF GetTipBkColor() const;

Rückgabewert

Ein COLORREF Wert, der die Hintergrundfarbe darstellt.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_GETTIPBKCOLOR, wie im Windows SDK beschrieben.

CToolTipCtrl::GetTipTextColor

Ruft die Textfarbe in einem QuickInfo-Fenster ab.

COLORREF GetTipTextColor() const;

Rückgabewert

Ein COLORREF Wert, der die Textfarbe darstellt.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_GETTIPTEXTCOLOR, wie im Windows SDK beschrieben.

CToolTipCtrl::GetTitle

Ruft den Titel des aktuellen QuickInfo-Steuerelements ab.

void GetTitle(PTTGETTITLE pttgt) const;

Parameter

pttgt
[out] Zeigen Sie auf eine TTGETTITLE Struktur, die Informationen zum QuickInfo-Steuerelement enthält. Wenn diese Methode zurückgegeben wird, verweist das pszTitle Element der TTGETTITLE Struktur auf den Text des Titels.

Hinweise

Diese Methode sendet die TTM_GETTITLE Nachricht, die im Windows SDK beschrieben wird.

CToolTipCtrl::GetToolCount

Ruft die Anzahl der Tools ab, die mit dem QuickInfo-Steuerelement registriert sind.

int GetToolCount() const;

Rückgabewert

Die Anzahl der Tools, die beim QuickInfo-Steuerelement registriert sind.

CToolTipCtrl::GetToolInfo

Ruft die Informationen ab, die ein QuickInfo-Steuerelement über ein Tool verwaltet.

BOOL GetToolInfo(
    CToolInfo& ToolInfo,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

Parameter

ToolInfo
Verweisen auf ein TOOLINFO Objekt, das den Text des Tools empfängt.

pWnd
Zeigen Sie auf das Fenster, das das Tool enthält.

nIDTool
ID des Tools.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Die hwnd Elemente uId der Struktur, auf die TOOLINFO verwiesen wird, indem CToolInfo Sie das Tool identifizieren. Wenn dieses Tool über einen vorherigen Aufruf AddToolmit dem QuickInfo-Steuerelement registriert wurde, wird die TOOLINFO Struktur mit Informationen zum Tool gefüllt.

CToolTipCtrl::HitTest

Testet einen Punkt, um festzustellen, ob es sich innerhalb des umgebenden Rechtecks des angegebenen Tools befindet, und ruft ggf. Informationen zum Tool ab.

BOOL HitTest(
    CWnd* pWnd,
    CPoint pt,
    LPTOOLINFO lpToolInfo) const;

Parameter

pWnd
Zeigen Sie auf das Fenster, das das Tool enthält.

pt
Zeigen Sie auf ein CPoint Objekt, das die Koordinaten des zu testenden Punkts enthält.

lpToolInfo
Zeiger auf TOOLINFO Struktur, die Informationen zum Tool enthält.

Rückgabewert

Nonzero, wenn sich der durch die Treffertestinformationen angegebene Punkt innerhalb des umgebenden Rechtecks des Tools befindet; andernfalls 0.

Hinweise

Wenn diese Funktion einen Wert ungleich Null zurückgibt, wird die struktur, auf lpToolInfo die verwiesen wird, mit Informationen über das Tool gefüllt, in dem sich das Rechteck befindet.

Die TTHITTESTINFO Struktur wird wie folgt definiert:

typedef struct _TT_HITTESTINFO { // tthti
    HWND hwnd;   // handle of tool or window with tool
    POINT pt;    // client coordinates of point to test
    TOOLINFO ti; // receives information about the tool
} TTHITTESTINFO, FAR * LPHITTESTINFO;

• hwnd

  Gibt den Ziehpunkt des Tools an.

• pt

  Gibt die Koordinaten eines Punkts an, wenn sich der Punkt im umgebenden Rechteck des Tools befindet.

• ti

  Informationen zum Tool. Weitere Informationen zur TOOLINFO Struktur finden Sie unter CToolTipCtrl::GetToolInfo.

CToolTipCtrl::Pop

Entfernt ein angezeigtes QuickInfo-Fenster aus der Ansicht.

void Pop();

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_POP, wie im Windows SDK beschrieben.

CToolTipCtrl::Popup

Bewirkt, dass das aktuelle QuickInfo-Steuerelement an den Koordinaten der letzten Mausnachricht angezeigt wird.

void Popup();

Hinweise

Diese Methode sendet die TTM_POPUP Nachricht, die im Windows SDK beschrieben wird.

Beispiel

Im folgenden Codebeispiel wird ein QuickInfo-Fenster angezeigt.

{
   // Display the most recent tooltip.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CToolTipCtrl *m_toolTip = m_toolBarCtrl.GetToolTips();
   m_toolTip->Popup();
}

CToolTipCtrl::RelayEvent

Übergibt eine Mausnachricht an ein QuickInfo-Steuerelement zur Verarbeitung.

void RelayEvent(LPMSG lpMsg);

Parameter

lpMsg
Zeigen Sie auf eine MSG Struktur, die die Nachricht enthält, die weitergeleitet werden soll.

Hinweise

Ein QuickInfo-Steuerelement verarbeitet nur die folgenden Nachrichten, die an sie gesendet werden:RelayEvent

WM_LBUTTONDOWN	WM_MOUSEMOVE
WM_LBUTTONUP	WM_RBUTTONDOWN
WM_MBUTTONDOWN	WM_RBUTTONUP
WM_MBUTTONUP

Beispiel

Ein Beispiel hierfür finden Sie unter CPropertySheet::GetTabControl.

CToolTipCtrl::SetDelayTime

Legt die Verzögerungszeit für ein QuickInfo-Steuerelement fest.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

Parameter

nDelay
Gibt die neue Verzögerungszeit in Millisekunden an.

dwDuration
Flag, das angibt, welcher Dauerwert abgerufen wird. Eine Beschreibung der gültigen Werte finden Sie unter.See CToolTipCtrl::GetDelayTime for a description of the valid values.

iTime
Die angegebene Verzögerungszeit in Millisekunden.

Hinweise

Die Verzögerungszeit ist die Zeitspanne, die der Cursor auf einem Tool verbleiben muss, bevor das QuickInfo-Fenster angezeigt wird. Die Standardverzögerungszeit beträgt 500 Millisekunden.

CToolTipCtrl::SetMargin

Legt die oberen, linken, unteren und rechten Seitenränder für ein QuickInfo-Fenster fest.

void SetMargin(LPRECT lprc);

Parameter

lprc
Adresse einer RECT Struktur, die die festzulegenden Randinformationen enthält. Die Elemente der RECT Struktur definieren kein umgebendes Rechteck. Eine Beschreibung der Randinformationen finden Sie unter.See CToolTipCtrl::GetMargin for a description of the margin information.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_SETMARGIN, wie im Windows SDK beschrieben.

CToolTipCtrl::SetMaxTipWidth

Legt die maximale Breite für ein QuickInfo-Fenster fest.

int SetMaxTipWidth(int iWidth);

Parameter

iWidth
Die maximale Breite des QuickInfo-Fensters, die festgelegt werden soll.

Rückgabewert

Die vorherige maximale Spitzenbreite.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_SETMAXTIPWIDTH, wie im Windows SDK beschrieben.

CToolTipCtrl::SetTipBkColor

Legt die Hintergrundfarbe in einem QuickInfo-Fenster fest.

void SetTipBkColor(COLORREF clr);

Parameter

clr
Die neue Hintergrundfarbe.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_SETTIPBKCOLOR, wie im Windows SDK beschrieben.

CToolTipCtrl::SetTipTextColor

Legt die Textfarbe in einem QuickInfo-Fenster fest.

void SetTipTextColor(COLORREF clr);

Parameter

clr
Die neue Textfarbe.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_SETTIPTEXTCOLOR, wie im Windows SDK beschrieben.

CToolTipCtrl::SetTitle

Fügt einer QuickInfo ein Standardsymbol und eine Titelzeichenfolge hinzu.

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

Parameter

uIcon
Siehe icon im TTM_SETTITLE Windows SDK.

lpstrTitle
Zeigen Sie auf die Titelzeichenfolge.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TTM_SETTITLE, wie im Windows SDK beschrieben.

CToolTipCtrl::SetToolInfo

Legt die Informationen fest, die eine QuickInfo für ein Tool verwaltet.

void SetToolInfo(LPTOOLINFO lpToolInfo);

Parameter

lpToolInfo
Ein Zeiger auf eine TOOLINFO Struktur, die die festzulegenden Informationen angibt.

CToolTipCtrl::SetToolRect

Legt ein neues umgebendes Rechteck für ein Tool fest.

void SetToolRect(
    CWnd* pWnd,
    UINT_PTR nIDTool,
    LPCRECT lpRect);

Parameter

pWnd
Zeigen Sie auf das Fenster, das das Tool enthält.

nIDTool
ID des Tools.

lpRect
Zeigen Sie auf eine RECT Struktur, die das neue umgebende Rechteck angibt.

CToolTipCtrl::SetWindowTheme

Legt die visuelle Formatvorlage des QuickInfo-Fensters fest.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameter

pszSubAppName
Ein Zeiger auf eine Unicode-Zeichenfolge, die die festzulegende visuelle Formatvorlage enthält.

Rückgabewert

Der Rückgabewert wird nicht verwendet.

Hinweise

Diese Memberfunktion emuliert die Funktionalität der TTM_SETWINDOWTHEME Nachricht, wie im Windows SDK beschrieben.

CToolTipCtrl::Update

Erzwingt, dass das aktuelle Tool neu gezeichnet wird.

void Update();

CToolTipCtrl::UpdateTipText

Aktualisiert den QuickInfo-Text für die Tools dieses Steuerelements.

void UpdateTipText(
    LPCTSTR lpszText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

void UpdateTipText(
    UINT nIDText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

Parameter

lpszText
Zeigen Sie auf den Text für das Tool.

pWnd
Zeigen Sie auf das Fenster, das das Tool enthält.

nIDTool
ID des Tools.

nIDText
ID der Zeichenfolgenressource, die den Text für das Tool enthält.

Siehe auch

CWnd Klasse
Hierarchiediagramm
CToolBar Klasse