CDockablePane-Klasse

Artikel
02/26/2013

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

class CDockablePane : public CPane

Mitglieder

Öffentliche Konstruktoren

Name	Description
CDockablePane::CDockablePane	erstellt und initialisiert ein CDockablePane-Objekt.

Ö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

Geschü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.

Datenmember

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.

Hinweis

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.

Hinweis
Zustandsinformationen werden zur Windows-Registrierung gespeichert.

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::Create CDockablePane::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);