CMFCPropertyGridToolTipCtrl-Klasse
Implementiert ein QuickInfo-Steuerelement, das von der CMFCPropertyGridCtrl-Klasse zum Anzeigen von QuickInfos verwendet wird.
class CMFCPropertyGridToolTipCtrl : public CWnd
| Name | Beschreibung |
|---|---|
| CMFCPropertyGridToolTipCtrl::CMFCPropertyGridToolTipCtrl | Erstellt ein CMFCPropertyGridToolTipCtrl-Objekt. |
CMFCPropertyGridToolTipCtrl::~CMFCPropertyGridToolTipCtrl |
Destruktor. |
| Name | Beschreibung |
|---|---|
| CMFCPropertyGridToolTipCtrl::Create | Erstellt ein Fenster für das QuickInfo-Steuerelement. |
| CMFCPropertyGridToolTipCtrl::D eactivate | Deaktiviert und blendet das QuickInfo-Steuerelement aus. |
| CMFCPropertyGridToolTipCtrl::GetLastRect | Gibt die Koordinaten der letzten Position des QuickInfo-Steuerelements zurück. |
| CMFCPropertyGridToolTipCtrl::Hide | Blendet das QuickInfo-Steuerelement aus. |
CMFCPropertyGridToolTipCtrl::PreTranslateMessage |
Wird von der CWinApp -Klasse verwendet, um Fenstermeldungen zu übersetzen, bevor diese an die Windows-Funktionen TranslateMessage und DispatchMessage gesendet werden. (Überschreibt CWnd::PreTranslateMessage.) |
| CMFCPropertyGridToolTipCtrl::SetTextMargin | Legt den Abstand zwischen dem QuickInfo-Text und dem Rahmen des QuickInfo-Fensters fest. |
| CMFCPropertyGridToolTipCtrl::Track | Zeigt das QuickInfo-Steuerelement an. |
QuickInfos werden angezeigt, wenn sich der Zeiger auf einem Eigenschaftennamen befindet. Die CMFCPropertyGridToolTipCtrl-Klasse zeigt eine QuickInfo an, sodass sie vom Benutzer leicht lesbar ist. In der Regel wird die Position einer QuickInfo durch die Position des Zeigers bestimmt. Mithilfe dieser Klasse wird die QuickInfo über dem Eigenschaftennamen angezeigt und ähnelt der natürlichen Eigenschaftenerweiterung, sodass der Eigenschaftsname vollständig sichtbar ist.
MFC erstellt dieses Steuerelement automatisch und verwendet es in der CMFCPropertyGridCtrl-Klasse.
Im folgenden Beispiel wird das Erstellen eines Objekts der CMFCPropertyGridToolTipCtrl Klasse und das Anzeigen des QuickInfo-Steuerelements veranschaulicht.
CMFCPropertyGridToolTipCtrl *pToolTipCtrl = new CMFCPropertyGridToolTipCtrl();
CRect crect(1, 1, 50, 50);
pToolTipCtrl->Track(crect, _T("this is a tool tip control"));
Header: afxpropertygridtooltipctrl.h
Erstellt ein CMFCPropertyGridToolTipCtrl-Objekt.
CMFCPropertyGridToolTipCtrl::CMFCPropertyGridToolTipCtrl();
Erstellt ein Fenster für das QuickInfo-Steuerelement.
BOOL Create(CWnd* pWndParent);
pWndParent
[in] Ein Zeiger auf das übergeordnete Fenster.
TRUE, wenn das Fenster erfolgreich erstellt wurde; andernfalls FALSE.
Deaktiviert und blendet das QuickInfo-Steuerelement aus.
void Deactivate();
Diese Methode legt die letzte Position und den Text auf leere Werte fest, sodass zukünftige Aufrufe von CMFCPropertyGridToolTipCtrl::Track die QuickInfo anzeigen.
Gibt die Koordinaten der letzten Position des QuickInfo-Steuerelements zurück.
void GetLastRect(CRect& rect) const;
rect
[out] Enthält die letzte Position des QuickInfo-Steuerelements.
Blendet das QuickInfo-Steuerelement aus.
void Hide();
Legt den Abstand zwischen dem QuickInfo-Text und dem Rahmen des QuickInfo-Fensters fest.
void SetTextMargin(int nTextMargin);
nTextMargin
[in] Gibt den Abstand zwischen dem QuickInfo-Steuerelementtext und dem Rahmen des QuickInfo-Fensters an. Der Standardwert ist 10 Pixel.
Zeigt das QuickInfo-Steuerelement an.
void Track(
CRect rect,
const CString& strText);
rect
[in] Gibt die Position und Größe des QuickInfo-Steuerelements an.
strText
[in] Gibt den Text an, der in der QuickInfo angezeigt werden soll.
Diese Methode zeigt das QuickInfo-Steuerelement an der Position und Größe an, die durch rect angegeben wird. Wenn sich die Position, größe und der Text seit dem letzten Aufruf dieser Methode nicht geändert haben, hat diese Methode keine Auswirkung.