CMFCAutoHideButton-Klasse

Eine Schaltfläche, die CDockablePane Class anzeigt oder ausblendet (vorausgesetzt, die Klasse ist so konfiguriert, dass sie ausgeblendet werden kann).

Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer 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

CObject

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 Standard Rahmenfenster 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

Siehe auch

Hierarchiediagramm
Klassen
CMFCAutoHideBar-Klasse
CAutoHideDockSite-Klasse