Freigeben über

CDockablePane-Klasse

  • Artikel

Implementiert einen Bereich, der entweder in eine Docksite angedockt oder in einer Seite im Registerformat enthalten sein kann.

class CDockablePane : public CPane

Mitglieder

Bb984433.collapse_all(de-de,VS.110).gifÖffentliche Konstruktoren

Name

Description

CDockablePane::CDockablePane

erstellt und initialisiert ein CDockablePane-Objekt.

Bb984433.collapse_all(de-de,VS.110).gifÖffentliche Methoden

Name

Description

CDockablePane::AttachToTabWnd

Fügt einen Bereich zu einem anderen Bereich an.Dadurch wird eine Seite im Registerformat erstellt.

CDockablePane::CalcFixedLayout

Gibt die Größe des Bereichsrechtecks zurück.

CDockablePane::CanAcceptMiniFrame

Bestimmt, ob die angegebenen Miniframe zum Bereich angedockt werden können.

CDockablePane::CanAcceptPane

Bestimmt, ob ein anderer Bereich auf den aktuellen Bereich angedockt werden kann.

CDockablePane::CanAutoHide

Bestimmt, ob der Bereich Modus "Automatisches Ausblenden" unterstützt.(Überschreibungen CBasePane::CanAutoHide.)

CDockablePane::CanBeAttached

Bestimmt, ob der aktuelle Bereich zu einem anderen Bereich angedockt werden kann.

CDockablePane::ConvertToTabbedDocument

Konvertiert eine oder mehrere andockbare Fenster zu MDI mit den versehenen Dokumenten.

CDockablePane::CopyState

Kopiert den Zustand eines andockbaren Fensters.

CDockablePane::Create

Erstellt das Windows-Steuerelement und fügt es dem CDockablePane-Objekt.

CDockablePane::CreateDefaultPaneDivider

Erstellt einen standardmäßigen Unterteiler für den Bereich, während er einem Rahmenfenster angedockt ist.

CDockablePane::CreateEx

Erstellt das Windows-Steuerelement und fügt es dem CDockablePane-Objekt.

CDockablePane::CreateTabbedPane

Stellt eine Seite im Registerformat im aktuellen Bereich erstellt.

CDockablePane::DockPaneContainer

Dockt einen Container zum Bereich an.

CDockablePane::DockPaneStandard

Dockt einen Bereich mithilfe des durch Andocken der Kontur (Standard) an.

CDockablePane::DockToFrameWindow

Wird intern verwendet.Um einen Bereich anzudocken, verwenden Sie CPane::DockPane oder CDockablePane::DockToWindow.

CDockablePane::DockToRecentPos

Dockt einen Bereich zu der neuen gespeicherten Andockenposition an.

CDockablePane::DockToWindow

wird ein Andocker Bereich zu einem anderen Hauptandockbereich.

CDockablePane::EnableAutohideAll

Aktiviert oder deaktiviert Modus "Automatisches Ausblenden" für diesen Bereich zusammen mit anderen Bereichen im Container.

CDockablePane::EnableGripper

In oder aus die Beschriftung (Ziehpunkt).

CDockablePane::GetAHRestoredRect

Gibt die Position des Bereichs an, wenn sichtbar im Modus "Automatisches Ausblenden".

CDockablePane::GetAHSlideMode

Ruft den Folienmodus der automatischen Ausblenden für den Bereich.

CDockablePane::GetAutoHideButton

Wird intern verwendet.

CDockablePane::GetAutoHideToolBar

Wird intern verwendet.

CDockablePane::GetCaptionHeight

Gibt die Höhe der aktuellen Beschriftung zurück.

CDockablePane::GetDefaultPaneDivider

Gibt den Standardwert Bereichsteiler für den Container des Bereichs zurück.

CDockablePane::GetDockingStatus

Bestimmt die Fähigkeit eines Bereichs, anhand des bereitgestellten Zeigerposition angedockt werden.

CDockablePane::GetDragSensitivity

Gibt die Ziehempfindlichkeit eines andockbaren Bereichs zurück.

CDockablePane::GetLastPercentInPaneContainer

Ruft den Prozentsatz des Speichers ab, den ein Bereich innerhalb seines Containers belegt.

CDockablePane::GetTabArea

Ruft den Registerkartenbereich für den Bereich.

CDockablePane::GetTabbedPaneRTC

Gibt die Ablaufklasseninformationen über ein Fenster im Registerkartenformat zurück, das erstellt wird, wenn ein anderer Bereich auf den aktuellen Bereich angedockt werden.

CDockablePane::HasAutoHideMode

Gibt an, ob ein Andocker Bereich den Modus "Automatisches Ausblenden" umgeschaltet werden kann.

CDockablePane::HitTest

Gibt den bestimmten Position in einem Bereich, in dem der Benutzer auf eine Maus klickt.

CDockablePane::IsAccessibilityCompatible

Wird intern verwendet.

CDockablePane::IsAutohideAllEnabled

Gibt an, ob der andockbare Bereich und alle anderen Bereiche im Container im Modus "Automatisches Ausblenden" eingefügt werden können.

CDockablePane::IsAutoHideMode

Bestimmt, ob ein Bereich im Modus "Automatisches Ausblenden" ist.

CDockablePane::IsChangeState

Wird intern verwendet.

CDockablePane::IsDocked

Bestimmt, ob der aktuelle Bereich angedockt ist.

CDockablePane::IsHideInAutoHideMode

Bestimmt das Verhalten eines Bereichs, der im Modus "Automatisches Ausblenden" ist, wenn es wird angezeigt (oder ausgeblendet), indem ShowPane aufruft.

CDockablePane::IsInFloatingMultiPaneFrameWnd

Gibt an, ob der Bereich in einem Rahmenfenster mit mehreren Bereichen ist.

CDockablePane::IsResizable

Gibt an, ob der Bereich veränderbar ist.

CDockablePane::IsTabLocationBottom

Gibt an, ob Registerkarten oben oder unter im Bereich befinden.

CDockablePane::IsTracked

Gibt an, ob ein Bereich vom Benutzer gezogen wird.

CDockablePane::IsVisible

Bestimmt, ob der aktuelle Bereich sichtbar ist.

CDockablePane::LoadState

Wird intern verwendet.

CDockablePane::OnAfterChangeParent

Aufgerufen vom Framework, wenn das übergeordnete Element eines Bereichs geändert hat.(Überschreibungen CPane::OnAfterChangeParent.)

CDockablePane::OnAfterDockFromMiniFrame

Aufgerufen vom Framework wenn wird eine unverankerte Andockenleiste an einem Rahmenfenster.

CDockablePane::OnBeforeChangeParent

Aufgerufen vom Framework, wenn das übergeordnete Element des Bereichs im Begriff ist zu ändern.(Überschreibungen CPane::OnBeforeChangeParent.)

CDockablePane::OnBeforeFloat

Aufgerufen vom Framework ausgelöst, wenn ein Bereich im Begriff ist von Fenstern.(Überschreibungen CPane::OnBeforeFloat.)

CDockablePane::RemoveFromDefaultPaneDividier

Das Framework ruft diese Methode auf, wenn ein Bereich abgedockt wird.

CDockablePane::ReplacePane

Ersetzt den Bereich durch einen angegebenen Bereich.

CDockablePane::RestoreDefaultPaneDivider

Das Framework ruft diese Methode auf, während ein Bereich deserialisiert wird, um den standardmäßigen Bereichsteiler wiederherzustellen.

CDockablePane::SaveState

Wird intern verwendet.

CDockablePane::Serialize

Serialisiert den Bereich.(Überschreibungen CBasePane::Serialize.)

CDockablePane::SetAutoHideMode

Schaltet den Hauptandockbereich zwischen und und Modus "Automatisches Ausblenden" um.

CDockablePane::SetAutoHideParents

Legt die Schaltfläche der automatische Ausblendenen automatische Ausblenden und die Symbolleiste der automatische Ausblendenen automatische Ausblenden für den Bereich fest.

CDockablePane::SetDefaultPaneDivider

Wird intern verwendet.

CDockablePane::SetLastPercentInPaneContainer

Legt den Prozentsatz des Bereichs fest, den ein Bereich innerhalb seines Containers belegt.

CDockablePane::SetResizeMode

Wird intern verwendet.

CDockablePane::SetRestoredDefaultPaneDivider

Legt den wiederhergestellten Standard Bereichsteiler fest.

CDockablePane::SetTabbedPaneRTC

Legt die Ablaufklasseninformationen für ein Fenster im Registerkartenformat fest, das erstellt wird, wenn zwei Bereiche zusammen andocken.

CDockablePane::ShowPane

In oder aus ein Bereich.

CDockablePane::Slide

Zeigt an oder blendet einen Bereich mit einer gleitenden Animation aus, das angezeigt wird, wenn der Bereich im Modus "Automatisches Ausblenden" ist.

CDockablePane::ToggleAutoHide

Schaltet Modus "Automatisches Ausblenden" um.(Überschreibungen CPane::ToggleAutoHide .)

CDockablePane::UndockPane

Dockt einen Bereich entweder vom Hauptrahmenfenster oder einem Minirahmenfenstercontainer ab.

CDockablePane::UnSetAutoHideMode

Wird intern verwendet.Um den Modus "Automatisches Ausblenden" festzulegen, verwenden Sie CDockablePane::SetAutoHideMode

Bb984433.collapse_all(de-de,VS.110).gifGeschützte Methoden

Name

Description

CDockablePane::CheckAutoHideCondition

Bestimmt, ob der andockbare Bereich ausgeblendet wird (im Modus "Automatisches Ausblenden").

CDockablePane::CheckStopSlideCondition

Bestimmt, ob ein Andocker Bereich der automatische Ausblendenen automatische Ausblenden zu schieben beendet werden soll.

CDockablePane::DrawCaption

Zeichnet die andockbare Bereichsbeschriftung (Ziehpunkt).

CDockablePane::OnPressButtons

Aufgerufen, wenn der Benutzer eine Beschriftungsschaltfläche als die AFX_HTCLOSE und AFX_HTMAXBUTTON Schaltflächen drückt.

CDockablePane::OnSlide

Aufgerufen vom Framework, um den Folieneffekt der automatische Ausblendenen automatische Ausblenden zu rendern, wenn der Bereich entweder ein- oder ausgeblendet wird.

Bb984433.collapse_all(de-de,VS.110).gifDatenmember

Name

Description

CDockablePane::m_bDisableAnimation

Gibt an, ob der Animation automatische Ausblendenen automatische Ausblenden des andockbaren Fensters deaktiviert ist.

CDockablePane::m_bHideInAutoHideMode

Bestimmt das Verhalten des Bereichs, wenn der Bereich im Modus "Automatisches Ausblenden" ist.

CDockablePane::m_nSlideSteps

Gibt die Animationsgeschwindigkeit des Bereichs an, wenn sie sich im Modus "Automatisches Ausblenden" angezeigt oder ausgeblendet wird.

Hinweise

CDockablePane implementiert die folgende Funktionalität:

  • Andocken eines Bereichs einen Hauptrahmenfenster.

  • Umschalten eines Bereichs für den Modus "Automatisches Ausblenden".

  • Anfügen eines Bereichs in ein Fenster im Registerkartenformat.

  • unverankert eines Bereichs in einem Minirahmenfenster.

  • Markieren eines Bereichs zu einem anderen Bereich andocken, der in einem Minirahmenfenster unverankert ist.

  • Ändern der Größe eines Bereichs.

  • Laden und Einsparungszustand für einen Hauptandockbereich.

    HinweisHinweis

    Zustandsinformationen werden zur Windows-Registrierung gespeichert.

  • Erstellen eines Bereichs mit oder ohne eine Beschriftung.Die Beschriftung kann eine Beschriftung haben und kann mit einer Farbverlaufsfarbe gefüllt werden.

  • Ziehen eines Bereichs beim Anzeigen des Inhalts des Bereichs

  • Ziehen eines Bereichs beim Anzeigen eines Ziehrechtecks.

Um einen Hauptandockbereich in der Anwendung zu verwenden, leiten Sie die Bereichsklasse aus der CDockablePane-Klasse.Entweder betten Sie das abgeleitete Objekt in das Hauptrahmenfensterobjekt oder in ein Fensterobjekt ein, das die Instanz des Bereichs steuert.Rufen Sie dann die CDockablePane::CreateCDockablePane::CreateEx-Methode oder die Methode auf, wenn Sie die WM_CREATE Meldung im Hauptrahmenfenster verarbeiten.Schließlich installieren Sie das Bereichsobjekt, indem Sie CBasePane::EnableDocking, CBasePane::DockPane oder CDockablePane::AttachToTabWnd aufrufen.

Anpassungs-Tipps

Die folgenden Tipps gelten für CDockablePane-Objekte:

  • Wenn Sie CDockablePane::AttachToTabWnd für zwei nicht-imRegisterkartenformat aufrufen, werden andockbare Fenster, ein Zeiger auf ein Fenster im Registerkartenformat im ppTabbedControlBar-Parameter zurückgegeben.Sie können weiterhin, um Registerkarten zum Fenster im Registerkartenformat hinzuzufügen, indem Sie diesen Parameter verwenden.

  • Die Art der Seite im Registerformat, die von CDockablePane::AttachToTabWnd erstellt wird, wird durch das CDockablePane-Objekt im pTabControlBarAttachTo-Parameter bestimmt.Sie können CDockablePane::SetTabbedPaneRTC aufrufen, um die Art der Seite im Registerformat festzulegen, die CDockablePane erstellt.Der Standardtyp wird durch dwTabbedStyle von CDockablePane::Create bestimmt, wenn Sie zuerst CDockablePane erstellen.Wenn dwTabbedStyle AFX_CBRS_OUTLOOK_TABS ist, ist der Standardtyp CMFCOutlookBar-Klasse; wenn dwTabbedStyle AFX_CBRS_REGULAR_TABS ist, ist der Standardtyp CTabbedPane-Klasse.

  • Wenn Sie ein andockbares Fenster zu anderen andocken möchten, rufen Sie die CDockablePane::DockToWindow-Methode auf.Der ursprüngliche Bereich muss irgendwo angedockt werden, bevor Sie diese Methode aufrufen.

  • Die Membervariable CDockablePane::m_bHideInAutoHideMode-Steuerelemente, wie andockbare Fenster im Modus der automatischen Ausblenden verhalten, wenn Sie CDockablePane::ShowPane aufrufen.Wenn diese Membervariable zu TRUE festgelegt ist, werden andockbare Fenster und ihre Schaltflächen der automatischen Ausblenden ausgeblendet.Andernfalls schieben diese in und aus.

  • Sie können Animation der automatische Ausblendenen automatische Ausblenden deaktivieren, indem Sie die CDockablePane::m_bDisableAnimation-Membervariable zu TRUE festlegen.

Beispiel

Das folgende Beispiel zeigt, wie ein Objekt CDockablePane konfiguriert, indem verschiedene Methoden in der CDockablePane-Klasse angewendet wird.Das Beispiel veranschaulicht, wie die automatische Ausblendenen automatische Ausblenden alle Funktion für das andockbare Fenster aktiviert, die Beschriftung oder den Ziehpunkt aktiviert, den Modus "Automatisches Ausblenden" aktiviert, den Bereich anzeigt und einen Bereich animiert, der im Modus "Automatisches Ausblenden" ist.Dieser Codeausschnitt ist Teil Visual Studio-Demobeispiel.

    // GetOwner is an inherited method.
    CDockablePane* pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());


...


        pParentBar->EnableAutohideAll();
        pParentBar->EnableGripper(true);
        pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
        pParentBar->ShowPane(true,false,true);
        pParentBar->Slide(true);

Vererbungshierarchie

CObject

   CCmdTarget

      CWnd

         CBasePane

            CPane

               CDockablePane

Anforderungen

Header: afxDockablePane.h

Siehe auch

Referenz

Hierarchien-Diagramm

CPane-Klasse

Weitere Ressourcen

MFC-Klassen