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 Standard für ein Tool enthält. |
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 Standard enthalten sind. |
CToolTipCtrl::GetToolInfo |
Ruft die Informationen ab, die ein QuickInfo-Steuerelement Standard über ein Tool enthält. |
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 |
Legt die Anfänglichen, Popup- und Anzeigedauern für ein QuickInfo-Steuerelement fest. |
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 Standard für ein Tool enthält. |
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 Tool Tipps in Windows, das nicht von CFrameWndabgeleitet wurde.
Weitere Informationen zur Verwendung CToolTipCtrlfinden Sie unter "Steuerelemente und Verwenden" CToolTipCtrl.
Vererbungshierarchie
CToolTipCtrl
Anforderungen
Headerafxcmn.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
Sehen Sie sich das Beispiel für 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
Sehen Sie sich das Beispiel für 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
Sehen Sie sich das Beispiel für 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_AUTOPOPRufen Sie die Dauer des QuickInfo-Fensters neu ab Standard s sichtbar, wenn der Zeiger innerhalb des umgebenden Rechtecks eines Tools steht.TTDT_INITIALRufen Sie die Dauer ab, die der Zeiger innerhalb des umgebenden Rechtecks eines Tools wieder Standard muss, bevor das QuickInfo-Fenster angezeigt wird.TTDT_RESHOWRufen 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 Standard für ein Tool enthält.
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 Standard über ein Tool enthält.
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;
hwndGibt den Ziehpunkt des Tools an.
ptGibt die Koordinaten eines Punkts an, wenn sich der Punkt im umgebenden Rechteck des Tools befindet.
tiInformationen zum Tool. Weitere Informationen zur
TOOLINFOStruktur finden Sie unterCToolTipCtrl::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
Sehen Sie sich das Beispiel für 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 erneut ausführen muss Standard auf einem Tool, 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 Standard für ein Tool enthält.
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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für