CMFCAutoHideButton-Klasse
Eine Schaltfläche, die CDockablePane Class anzeigt oder ausblendet (vorausgesetzt, die Klasse ist so konfiguriert, dass sie ausgeblendet werden kann).
Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.
Syntax
class CMFCAutoHideButton : public CObject
Member
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CMFCAutoHideButton::BringToTop | |
| CMFCAutoHideButton::Create | Erstellt und initialisiert die Schaltfläche zum automatischen Ausblenden. |
| CMFCAutoHideButton::GetAlignment | Ruft die Ausrichtung der Schaltfläche zum automatischen Ausblenden ab. |
| CMFCAutoHideButton::GetAutoHideWindow | Gibt das CDockablePane -Objekt zurück, das der Schaltfläche zum automatischen Ausblenden zugeordnet ist. |
| CMFCAutoHideButton::GetParentToolBar | |
| CMFCAutoHideButton::GetRect | |
| CMFCAutoHideButton::GetSize | Legt die Größe der Schaltfläche zum automatischen Ausblenden fest. |
| CMFCAutoHideButton::GetTextSize | Gibt die Größe der Textbeschriftung für die Schaltfläche zum automatischen Ausblenden zurück. |
| CMFCAutoHideButton::HighlightButton | Hebt die Schaltfläche zum automatischen Ausblenden hervor. |
| CMFCAutoHideButton::IsActive | Gibt an, ob die Schaltfläche zum automatischen Ausblenden aktiv ist. |
| CMFCAutoHideButton::IsHighlighted | Gibt den Hervorhebestatus der Schaltfläche zum automatischen Ausblenden zurück. |
| CMFCAutoHideButton::IsHorizontal | Bestimmt, ob die Schaltfläche zum automatischen Ausblenden horizontal oder vertikal ist. |
| CMFCAutoHideButton::IsTop | |
| CMFCAutoHideButton::IsVisible | Gibt an, ob die Schaltfläche sichtbar ist. |
| CMFCAutoHideButton::Move | |
| CMFCAutoHideButton::OnDraw | Das Framework ruft diese Methode auf, wenn es die Schaltfläche zum automatischen Ausblenden zeichnet. |
| CMFCAutoHideButton::OnDrawBorder | Das Framework ruft diese Methode auf, wenn es den Rahmen einer Schaltfläche zum automatischen Ausblenden zeichnet. |
| CMFCAutoHideButton::OnFillBackground | Das Framework ruft diese Methode auf, wenn es den Hintergrund einer Schaltfläche zum automatischen Ausblenden füllt. |
| CMFCAutoHideButton::ReplacePane | |
| CMFCAutoHideButton::ShowAttachedWindow | Blendet die zugeordnete CDockablePane-Klasse ein oder aus. |
| CMFCAutoHideButton::ShowButton | Blendet die Schaltfläche zum automatischen Ausblenden ein oder aus. |
| CMFCAutoHideButton::UnSetAutoHideMode |
Hinweise
Beim Erstellen wird das CMFCAutoHideButton Objekt an eine CDockablePane-Klasse angefügt. Das CDockablePane-Objekt wird ausgeblendet oder angezeigt, wenn der Benutzer mit dem CMFCAutoHideButton-Objekt interagiert.
Standardmäßig erstellt das Framework automatisch eine CMFCAutoHideButton, wenn der Benutzer das automatische Ausblenden aktiviert. Das Framework kann ein Element einer benutzerdefinierten Benutzeroberflächenklasse erstellen, anstatt der CMFCAutoHideButton-Klasse. Um festzulegen, welche benutzerdefinierte Benutzeroberflächenklasse das Framework verwenden soll, legen Sie die statische Membervariable CMFCAutoHideBar::m_pAutoHideButtonRTS auf den gleichen Wert wie die benutzerdefinierte Benutzeroberflächenklasse fest. Standardmäßig ist diese Variable auf CMFCAutoHideButton festgelegt.
Beispiel
Das folgende Beispiel veranschaulicht das Erstellen eines CMFCAutoHideButton-Objekts, und die Verwendung verschiedener Methoden in der CMFCAutoHideButton-Klasse. Das Beispiel veranschaulicht, wie Sie ein CMFCAutoHideButton-Objekt mithilfe seiner Create-Methode initialisieren, die zugeordnete CDockablePane-Klasse anzeigen und die Schaltfläche zum automatischen Ausblenden anzeigen.
CMFCAutoHideButton *autoHideButton = new CMFCAutoHideButton();
CDockablePane cPane;
// CMFCAutoHideBar* pParentBar
if (!autoHideButton->Create(pParentBar, &cPane, CBRS_ALIGN_LEFT))
{
return 0;
}
autoHideButton->ShowAttachedWindow(true);
autoHideButton->ShowButton(true);
Vererbungshierarchie
CMFCAutoHideButton
Anforderungen
Header: afxautohidebutton.h
CMFCAutoHideButton::BringToTop
void BringToTop();
Hinweise
CMFCAutoHideButton::Create
Erstellt und initialisiert eine Schaltfläche zum automatischen Ausblenden.
virtual BOOL Create(
CMFCAutoHideBar* pParentBar,
CDockablePane* pAutoHideWnd,
DWORD dwAlignment);
Parameter
pParentBar
[in] Ein Zeiger auf die übergeordnete Symbolleiste.
pAutoHideWnd
[in] Ein Zeiger auf ein CDockablePane-Objekt . Diese Schaltfläche zum automatischen Ausblenden wird ausgeblendet und zeigt dies CDockablePanean.
dwAlignment
[in] Ein Wert, der die Ausrichtung der Schaltfläche mit dem Hauptrahmenfenster angibt.
Rückgabewert
Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).
Hinweise
Wenn Sie ein CMFCAutoHideButton Objekt erstellen, müssen Sie die Schaltfläche zum automatischen Ausblenden einer bestimmten CDockablePaneSchaltfläche zuordnen. Der Benutzer kann die Schaltfläche zum automatischen Ausblenden verwenden, um die zugeordnete CDockablePaneSchaltfläche auszublenden und anzuzeigen.
Der dwAlignment-Parameter gibt an, wo sich die Schaltfläche zum automatischen Ausblenden in der Anwendung befindet. Der Parameter kann auf einen der folgenden Werte festgelegt werden:
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CMFCAutoHideButton::GetAlignment
Ruft die Ausrichtung der Schaltfläche zum automatischen Ausblenden ab.
DWORD GetAlignment() const;
Rückgabewert
Ein DWORD-Wert, der die aktuelle Ausrichtung der Schaltfläche zum automatischen Ausblenden enthält.
Hinweise
Die Ausrichtung der Schaltfläche zum automatischen Ausblenden gibt an, wo sich die Schaltfläche in der Anwendung befindet. Dabei kann es sich um einen der folgenden Werte handeln:
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CRBS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CMFCAutoHideButton::GetAutoHideWindow
Gibt das CDockablePane -Objekt zurück, das der Schaltfläche zum automatischen Ausblenden zugeordnet ist.
CDockablePane* GetAutoHideWindow() const;
Rückgabewert
Ein Zeiger auf das zugeordnete CDockablePane Objekt.
Hinweise
Um eine Schaltfläche zum automatischen Ausblenden einem CDockablePanezuzuordnen, übergeben Sie den CDockablePane Parameter als Parameter an die CMFCAutoHideButton::Create-Methode .
CMFCAutoHideButton::GetParentToolBar
CMFCAutoHideBar* GetParentToolBar();
Rückgabewert
Bemerkungen
CMFCAutoHideButton::GetRect
CRect GetRect() const;
Rückgabewert
Bemerkungen
CMFCAutoHideButton::GetSize
Legt die Größe der Schaltfläche zum automatischen Ausblenden fest.
CSize GetSize() const;
Rückgabewert
Ein CSize Objekt, das die Schaltflächengröße enthält.
Hinweise
Die berechnete Größe enthält die Größe des Rahmens der Schaltfläche zum automatischen Ausblenden.
CMFCAutoHideButton::GetTextSize
Gibt die Größe der Textbeschriftung für die Schaltfläche zum automatischen Ausblenden zurück.
virtual CSize GetTextSize() const;
Rückgabewert
Ein CSize-Objekt , das die Größe des Texts für die Schaltfläche zum automatischen Ausblenden enthält.
CMFCAutoHideButton::IsActive
Gibt an, ob die Schaltfläche zum automatischen Ausblenden aktiv ist.
BOOL IsActive() const;
Rückgabewert
TRUE, wenn die Schaltfläche zum automatischen Ausblenden aktiv ist; Andernfalls FALSE.
Hinweise
Eine Schaltfläche zum automatischen Ausblenden ist aktiv, wenn das zugeordnete CDockablePane-Klassenfenster angezeigt wird.
CMFCAutoHideButton::IsHorizontal
Bestimmt, ob die Schaltfläche zum automatischen Ausblenden horizontal oder vertikal ist.
BOOL IsHorizontal() const;
Rückgabewert
Nonzero, wenn die Schaltfläche horizontal ist; 0 andernfalls.
Hinweise
Das Framework legt die Ausrichtung eines CMFCAutoHideButton-Objekts fest, wenn Sie es erstellen. Sie können die Ausrichtung mithilfe des dwAlignment-Parameters in der CMFCAutoHideButton::Create-Methode steuern.
CMFCAutoHideButton::IsTop
BOOL IsTop() const;
Rückgabewert
Bemerkungen
CMFCAutoHideButton::IsVisible
Gibt an, ob die Schaltfläche zum automatischen Ausblenden sichtbar ist.
virtual BOOL IsVisible() const;
Rückgabewert
TRUE, wenn die Schaltfläche sichtbar ist; Andernfalls FALSE.
CMFCAutoHideButton::OnDraw
Das Framework ruft diese Methode auf, wenn es die Schaltfläche zum automatischen Ausblenden zeichnet.
virtual void OnDraw(CDC* pDC);
Parameter
pDC
[in] Ein Zeiger auf einen Gerätekontext.
Hinweise
Wenn Sie die Darstellung von Schaltflächen für das automatische Ausblenden in Ihrer Anwendung anpassen möchten, erstellen Sie eine neue Klasse, die von CMFCAutoHideButton. Überschreiben Sie diese Methode in der abgeleiteten Klasse.
CMFCAutoHideButton::OnDrawBorder
Das Framework ruft diese Methode auf, wenn es den Rahmen einer Schaltfläche zum automatischen Ausblenden zeichnet.
virtual void OnDrawBorder(
CDC* pDC,
CRect rectBounds,
CRect rectBorderSize);
Parameter
pDC
[in] Ein Zeiger auf einen Gerätekontext.
rectBounds
[in] Das umgebende Rechteck der Schaltfläche zum automatischen Ausblenden.
rectBorderSize
[in] Die Rahmenstärke für jede Seite der Schaltfläche zum automatischen Ausblenden.
Hinweise
Wenn Sie den Rahmen jeder Schaltfläche zum automatischen Ausblenden in Ihrer Anwendung anpassen möchten, erstellen Sie eine neue Klasse, die von der CMFCAutoHideButton. Überschreiben Sie diese Methode in der abgeleiteten Klasse.
CMFCAutoHideButton::OnFillBackground
Das Framework ruft diese Methode auf, wenn es den Hintergrund einer Schaltfläche zum automatischen Ausblenden füllt.
virtual void OnFillBackground(
CDC* pDC,
CRect rect);
Parameter
pDC
[in] Ein Zeiger auf einen Gerätekontext.
rect
[in] Das umgebende Rechteck der Schaltfläche zum automatischen Ausblenden.
Hinweise
Wenn Sie den Hintergrund für Schaltflächen für das automatische Ausblenden in Ihrer Anwendung anpassen möchten, erstellen Sie eine neue Klasse, die von der CMFCAutoHideButton. Überschreiben Sie diese Methode in der abgeleiteten Klasse.
CMFCAutoHideButton::ShowAttachedWindow
Blendet die zugeordnete CDockablePane-Klasse ein oder aus.
void ShowAttachedWindow(BOOL bShow);
Parameter
bShow
[in] Ein Boolescher Wert, der angibt, ob diese Methode die angefügte CDockablePaneMethode anzeigt.
CMFCAutoHideButton::ShowButton
Blendet die Schaltfläche zum automatischen Ausblenden ein oder aus.
virtual void ShowButton(BOOL bShow);
Parameter
bShow
[in] Ein Boolescher Wert, der angibt, ob die Schaltfläche zum automatischen Ausblenden angezeigt werden soll.
CMFCAutoHideButton::Move
void Move(int nOffset);
Parameter
[in] nOffset
Hinweise
CMFCAutoHideButton::ReplacePane
void ReplacePane(CDockablePane* pNewBar);
Parameter
[in] pNewBar
Hinweise
CMFCAutoHideButton::UnSetAutoHideMode
Deaktiviert den automatischen Ausblendemodus.
virtual void UnSetAutoHideMode(CDockablePane* pFirstBarInGroup);
Parameter
pFirstBarInGroup
[in] Ein Zeiger auf die erste Leiste in der Gruppe.
Hinweise
CMFCAutoHideButton::HighlightButton
Hebt die Schaltfläche zum automatischen Ausblenden hervor.
virtual void HighlightButton(BOOL bHighlight);
Parameter
bHighlight
Gibt den neuen Zustand der Schaltfläche zum automatischen Ausblenden an. TRUE gibt an, dass die Schaltfläche hervorgehoben ist. FALSE gibt an, dass die Schaltfläche nicht hervorgehoben ist.
Hinweise
CMFCAutoHideButton::IsHighlighted
Gibt den Hervorhebungsstatus der Schaltfläche zum automatischen Ausblenden zurück.
virtual BOOL IsHighlighted() const;
Rückgabewert
Gibt WAHR zurück, wenn die Schaltfläche zum automatischen Ausblenden hervorgehoben ist; andernfalls FALSE.
Hinweise
Weitere Informationen
Hierarchiediagramm
Klassen
CMFCAutoHideBar-Klasse
CAutoHideDockSite-Klasse