Freigeben über

CPane-Klasse

  • Artikel

Die CPane Klasse ist eine Erweiterung der CControlBar-Klasse. Wenn Sie ein vorhandenes MFC-Projekt aktualisieren, ersetzen Sie alle Vorkommen durch CControlBar CPane.

Syntax

class CPane : public CBasePane

Member

Öffentliche Konstruktoren

Name Beschreibung
CPane::~CPane Destruktor.

Öffentliche Methoden

Name Beschreibung
CPane::AdjustSizeImmediate Berechnet das Layout eines Bereichs sofort neu.
CPane::AllocElements Ordnet Speicher für die interne Verwendung zu.
CPane::AllowShowOnPaneMenu Gibt an, ob der Bereich in der laufzeitgenerierten Liste der Bereiche für die Anwendung aufgeführt ist.
CPane::CalcAvailableSize Berechnet den Unterschied zwischen einem angegebenen Rechteck und dem aktuellen Fensterrechteck.
CPane::CalcInsideRect Berechnet das innen liegende Rechteck eines Bereichs unter Berücksichtigung der Rahmen und Ziehelemente.
CPane::CalcRecentDockedRect Berechnet das zuletzt angedockte Rechteck.
CPane::CalcSize Berechnet die Größe des Bereichs.
CPane::CanBeDocked Bestimmt, ob der Bereich an den angegebenen Basisbereich angedockt werden kann.
CPane::CanBeTabbedDocument Bestimmt, ob der Bereich in ein Dokument mit Registerkarten konvertiert werden kann.
CPane::ConvertToTabbedDocument Wandelt einen andockbaren Bereich in ein Dokument mit Registerkartenformat um.
CPane::CopyState Kopiert den Status eines Bereichs. (Außerkraftsetzungen CBasePane::CopyState.)
CPane::Create Erstellt eine Steuerelementleiste und fügt sie an das CPane Objekt an.
CPane::CreateDefaultMiniframe Erstellt ein Miniframefenster für einen unverankerten Bereich.
CPane::CreateEx Erstellt eine Steuerelementleiste und fügt sie an das CPane Objekt an.
CPane::CreateObject Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CPane::D ockByMouse Dockt einen Bereich mithilfe der Maus-Docking-Methode an.
CPane::D ockPane Dockt den unverankerten Bereich an einen Basisbereich an.
CPane::D ockPaneStandard Dockt einen Bereich mithilfe der Gliederung (Standard)-Andockung an.
CPane::D ockToFrameWindow Dockt einen andockbaren Bereich an einen Frame an. (Überschreibt CBasePane::DockToFrameWindow.)
CPane::D oesAllowSiblingBars Gibt an, ob Sie einen anderen Bereich an derselben Zeile andocken können, in der der aktuelle Bereich angedockt ist.
CPane::FloatPane Floats the pane.
CPane::GetAvailableExpandSize Gibt den Wert in Pixeln zurück, den der Bereich erweitern kann.
CPane::GetAvailableStretchSize Gibt den Wert in Pixeln zurück, den der Bereich verkleinern kann.
CPane::GetBorders Gibt die Breite der Rahmen des Bereichs zurück.
CPane::GetClientHotSpot Gibt den Hotspot für den Bereich zurück.
CPane::GetDockSiteRow Gibt die Dockzeile zurück, in der der Bereich angedockt ist.
CPane::GetExclusiveRowMode Bestimmt, ob sich der Bereich im exklusiven Zeilenmodus befindet.
CPane::GetHotSpot Gibt den Hotspot zurück, der in einem zugrunde liegenden CMFCDragFrameImpl Objekt gespeichert ist.
CPane::GetMinSize Ruft die minimale zulässige Größe für den Bereich ab.
CPane::GetPaneName Ruft den Titel für den Bereich ab.
CPane::GetResizeStep Wird intern verwendet.
CPane::GetThisClass Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CPane::GetVirtualRect Ruft das virtuelle Rechteck des Bereichs ab.
CPane::IsChangeState Während der Bereich verschoben wird, analysiert diese Methode die Position des Bereichs relativ zu anderen Bereichen, Dockzeilen und Miniframefenstern und gibt den entsprechenden AFX_CS_STATUS Wert zurück.
CPane::IsDragMode Gibt an, ob der Bereich gezogen wird.
CPane::IsInFloatingMultiPaneFrameWnd Gibt an, ob sich der Bereich in einem Fenster mit mehreren Fenstern befindet. (Überschreibt CBasePane::IsInFloatingMultiPaneFrameWnd.)
CPane::IsLeftOf Bestimmt, ob der Bereich links von (oder oberhalb) des angegebenen Rechtecks liegt.
CPane::IsResizable Bestimmt, ob die Größe des Bereichs geändert werden kann. (Außerkraftsetzungen CBasePane::IsResizable.)
CPane::IsTabbed Bestimmt, ob der Bereich in das Registersteuerelement eines Registerkartenfensters eingefügt wurde. (Außerkraftsetzungen CBasePane::IsTabbed.)
CPane::LoadState Lädt den Status des Bereichs aus der Registrierung. (Außerkraftsetzungen CBasePane::LoadState.)
CPane::MoveByAlignment Verschiebt den Bereich und das virtuelle Rechteck um den angegebenen Betrag.
CPane::MovePane Verschiebt den Bereich zum angegebenen Rechteck.
CPane::OnAfterChangeParent Wird vom Framework aufgerufen, wenn sich das übergeordnete Element eines Bereichs geändert hat.
CPane::OnBeforeChangeParent Wird vom Framework aufgerufen, wenn sich das übergeordnete Element des Bereichs ändert.
CPane::OnPressCloseButton Wird vom Framework aufgerufen, wenn der Benutzer die Schaltfläche "Schließen" auf der Beschriftung für den Bereich auswäht.
CPane::OnProcessDblClk Wird intern verwendet.
CPane::OnShowControlBarMenu Wird von Framework aufgerufen, kurz bevor ein spezielles Bereichsmenü angezeigt wird.
CPane::OnShowControlBarMenu Wird von Framework aufgerufen, kurz bevor ein spezielles Bereichsmenü angezeigt wird.
CPane::PrepareToDock Wird intern verwendet.
CPane::RecalcLayout Berechnet Layoutinformationen für den Bereich neu. (Außerkraftsetzungen CBasePane::RecalcLayout.)
CPane::SaveState Speichert den Status des Bereichs in der Registrierung. (Außerkraftsetzungen CBasePane::SaveState.)
CPane::SetActiveInGroup Kennzeichnet einen Bereich als aktiv.
CPane::SetBorders Legt die Rahmenwerte des Bereichs fest.
CPane::SetClientHotSpot Legt den Hotspot für den Bereich fest.
CPane::SetDockState Stellt Die Andockstatusinformationen für den Bereich wieder her.
CPane::SetExclusiveRowMode Aktiviert oder deaktiviert den exklusiven Zeilenmodus.
CPane::SetMiniFrameRTC Legt die Laufzeitklasseninformationen für das Standardmäßige Miniframefenster fest.
CPane::SetMinSize Legt die minimale zulässige Größe für den Bereich fest.
CPane::SetVirtualRect Legt das virtuelle Rechteck des Bereichs fest.
CPane::StretchPaneDeferWndPos Gestreckt den Bereich vertikal oder horizontal basierend auf dem Andockstil.
CPane::ToggleAutoHide Schaltet den Modus zum automatischen Ausblenden um.
CPane::UndockPane Entfernt den Bereich von der Dockwebsite, dem Standardschieberegler oder dem Miniframefenster, in dem er derzeit verankert ist. (Außerkraftsetzungen CBasePane::UndockPane.)
CPane::UpdateVirtualRect Aktualisiert das virtuelle Rechteck.

Geschützte Methoden

Name Beschreibung
CPane::OnAfterDock Wird vom Framework aufgerufen, wenn ein Bereich angedockt wurde.
CPane::OnAfterFloat Wird vom Framework aufgerufen, wenn ein Bereich freigegeben wurde.
CPane::OnBeforeDock Wird vom Framework aufgerufen, wenn der Bereich angedockt werden soll.
CPane::OnBeforeFloat Wird vom Framework aufgerufen, wenn ein Bereich eingefloben werden soll.

Datenelemente

Name Beschreibung
CPane::m_bHandleMinSize Ermöglicht eine konsistente Behandlung der minimalen Größe für Bereiche.
CPane::m_recentDockInfo Enthält aktuelle Andockinformationen.

Hinweise

CPane In der Regel werden Objekte nicht direkt instanziiert. Wenn Sie einen Bereich mit Andockfunktionen benötigen, leiten Sie Ihr Objekt von CDockablePane ab. Wenn Sie Symbolleistenfunktionen benötigen, leiten Sie Ihr Objekt von CMFCToolBar ab.

Wenn Sie eine Klasse ableiten CPane, kann sie in einer CDockSite angedockt und in einem CPaneFrameWnd verschoben werden.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CBasePane

CPane

Anforderungen

Header: afxPane.h

CPane::AdjustSizeImmediate

Berechnet das Layout eines Bereichs sofort neu.

virtual void AdjustSizeImmediate(BOOL bRecalcLayout = TRUE);

Parameter

bRecalcLayout
[in] TRUE, um das Layout des Bereichs automatisch neu zu berechnen; andernfalls FALSE.

Hinweise

Rufen Sie diese Methode auf, wenn Sie das Layout eines Bereichs dynamisch ändern. Sie können diese Methode beispielsweise aufrufen, wenn Sie Symbolleistenschaltflächen ausblenden oder anzeigen.

CPane::AllocElements

Ordnet Speicher für die interne Verwendung zu.

BOOL AllocElements(
    int nElements,
    int cbElement);

Parameter

nElements
[in] Die Anzahl der Elemente, für die Speicher zugewiesen werden soll.

cbElement
[in] Die Größe eines Elements in Byte.

Rückgabewert

FALSE, wenn die Speicherzuweisung fehlschlägt; andernfalls TRUE.

CPane::AllowShowOnPaneMenu

Gibt an, ob der Bereich in der laufzeitgenerierten Liste der Bereiche für die Anwendung aufgeführt ist.

virtual BOOL AllowShowOnPaneMenu() const;

Rückgabewert

TRUE, wenn der Bereich in der Liste angezeigt wird; andernfalls FALSE. Die Basisimplementierung gibt immer TRUE zurück.

Hinweise

Die appWizard-generierte Anwendung enthält eine Menüoption, in der bereiche aufgelistet werden, die sie enthält. Diese Methode bestimmt, ob der Bereich in der Liste angezeigt wird.

CPane::CalcAvailableSize

Berechnet den Unterschied zwischen einem angegebenen Rechteck und dem aktuellen Fensterrechteck.

virtual CSize CalcAvailableSize(CRect rectRequired);

Parameter

rectRequired
[in] Das erforderliche Rechteck.

Rückgabewert

Der Unterschied zwischen Breite und Höhe zwischen rectRequired und dem aktuellen Fensterrechteck.

CPane::CalcInsideRect

Berechnet das innen liegende Rechteck eines Bereichs, einschließlich der Rahmen und Ziehelemente.

void CalcInsideRect(
    CRect& rect,
    BOOL bHorz) const;

Parameter

rect
[out] Enthält die Größe und den Offset des Clientbereichs des Bereichs.

bHorz
[in] TRUE, wenn der Bereich horizontal ausgerichtet ist; andernfalls FALSE.

Hinweise

Diese Methode wird vom Framework aufgerufen, wenn das Layout für einen Bereich neu berechnet werden muss. Der Rect-Parameter wird mit der Größe und dem Offset des Clientbereichs des Bereichs gefüllt. Dazu gehören die Rahmen und Ziehelemente.

CPane::CalcRecentDockedRect

Berechnet das zuletzt angedockte Rechteck.

void CalcRecentDockedRect();

Hinweise

Diese Methode aktualisiert CPane::m_recentDockInfo.

CPane::CalcSize

Berechnet die Größe des Bereichs.

virtual CSize CalcSize(BOOL bVertDock);

Parameter

bVertDock
[in] TRUE, wenn der Bereich vertikal angedockt wird, andernfalls FALSE.

Rückgabewert

Die Standardimplementierung dieser Methode gibt eine Größe von (0, 0) zurück.

Hinweise

Abgeleitete Klassen sollten diese Methode überschreiben.

CPane::CanBeDocked

Bestimmt, ob der Bereich an den angegebenen Basisbereich angedockt werden kann.

virtual BOOL CanBeDocked(CBasePane* pDockBar) const;

Parameter

pDockBar
[in] Gibt den Bereich an, in dem dieser Bereich verankert werden soll.

Rückgabewert

TRUE, wenn dieser Bereich an dem angegebenen Andockbereich angedockt werden kann; andernfalls FALSE.

Hinweise

Diese Methode wird in der Regel vom Framework aufgerufen, um zu bestimmen, ob ein Bereich an den angegebenen Dockingbereich angedockt werden kann. Um festzustellen, ob der Bereich angedockt werden kann, wertet die Methode die derzeit aktivierte Andockausrichtung des Bereichs aus.

Sie aktivieren das Andocken an den verschiedenen Seiten des Framefensters, indem Sie CBasePane::EnableDocking aufrufen.

CPane::CanBeTabbedDocument

Bestimmt, ob der Bereich in ein Dokument mit Registerkarten konvertiert werden kann.

virtual BOOL CanBeTabbedDocument() const;

Rückgabewert

TRUE, wenn der Bereich in ein Dokument mit Registerkarten konvertiert werden kann; andernfalls FALSE.

Hinweise

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, und geben Sie FALSE zurück, wenn Sie verhindern möchten, dass ein Bereich in ein Dokument mit Registerkarten konvertiert wird. Ein Dokument im Registerkartenformat wird nicht im Menü "Fensterposition" aufgeführt.

CPane::ConvertToTabbedDocument

Wandelt einen andockbaren Bereich in ein Dokument mit Registerkartenformat um.

virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);

Parameter

bActiveTabOnly
[in] Wird in CPane::ConvertToTabbedDocument.

Hinweise

Nur andockbare Bereiche können in Dokumente mit Registerkarten konvertiert werden. Weitere Informationen finden Sie unter CDockablePane::ConvertToTabbedDocument.

CPane::CopyState

Kopiert den Status eines Bereichs.

virtual void CopyState(CPane* pOrgBar);

Parameter

pOrgBar
[in] Ein Zeiger auf einen Bereich.

Hinweise

Diese Methode kopiert den Zustand von pOrgBar in den aktuellen Bereich.

CPane::Create

Erstellt eine Steuerelementleiste und fügt sie an das CPane -Objekt an.

virtual BOOL Create(
    LPCTSTR lpszClassName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle = AFX_DEFAULT_PANE_STYLE,
    CCreateContext* pContext = NULL);

Parameter

lpszClassName
[in] Gibt den Namen der Windows-Klasse an.

dwStyle
[in] Gibt die Attribute der Fensterformatvorlage an. Weitere Informationen finden Sie unter "Fensterformatvorlagen".

rect
[in] Gibt die anfängliche Größe und Position des pParentWnd-Fensters in Clientkoordinaten an.

pParentWnd
[in, out] Gibt das übergeordnete Fenster dieses Bereichs an.

Nid
[in] Gibt die ID des Bereichs an.

dwControlBarStyle
[in] Gibt die Formatvorlage für den Bereich an. Weitere Informationen finden Sie unter CBasePane::CreateEx.

pContext
[in, out] Gibt den Erstellungskontext des Bereichs an.

Rückgabewert

TRUE, wenn der Bereich erfolgreich erstellt wurde; andernfalls FALSE.

Hinweise

Diese Methode erstellt einen Windows-Bereich und fügt ihn an das CPane Objekt an.

Wenn Sie vor dem Aufruf Createnicht explizit CPane::m_recentDockInfo initialisiert haben, wird das Parameterrechteck beim Unverankerten oder Andocken des Bereichs als Rechteck verwendet.

CPane::CreateDefaultMiniframe

Erstellt ein Miniframefenster für einen unverankerten Bereich.

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Parameter

rectInitial
[in] Gibt die Anfängliche Größe und Position in Bildschirmkoordinaten des zu erstellenden Miniframefensters an.

Rückgabewert

Das neu erstellte Miniframefenster.

Hinweise

Diese Methode wird vom Framework aufgerufen, um ein Miniframefenster zu erstellen, wenn ein Bereich schwebt. Das Miniframefenster kann vom Typ "CPaneFrameWnd" oder vom Typ "CMultiPaneFrameWnd" sein. Ein Miniframefenster mit mehreren Fenstern wird erstellt, wenn der Bereich die AFX_CBRS_FLOAT_MULTI Formatvorlage aufweist.

Die Laufzeitklasseninformationen für das Miniframefenster werden im CPane::m_pMiniFrameRTC Element gespeichert. Sie können eine abgeleitete Klasse verwenden, um dieses Element festzulegen, wenn Sie benutzerdefinierte Miniframefenster erstellen möchten.

CPane::CreateEx

Erstellt eine Steuerelementleiste und fügt sie an das CPane -Objekt an.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszClassName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle = AFX_DEFAULT_PANE_STYLE,
    CCreateContext* pContext = NULL);

Parameter

dwStyleEx
[in] Gibt Attribute für erweiterte Fensterformatvorlagen an. Weitere Informationen finden Sie unter "Erweiterte Fensterarten".

lpszClassName
[in] Gibt den Namen der Windows-Klasse an.

dwStyle
[in] Gibt Fensterformatattribute an. Weitere Informationen finden Sie unter "Fensterformatvorlagen".

rect
[in] Gibt die anfängliche Größe und Position des pParentWnd-Fensters in Clientkoordinaten an.

pParentWnd
[in, out] Gibt das übergeordnete Fenster dieses Bereichs an.

Nid
[in] Gibt die ID des Bereichs an.

dwControlBarStyle
[in] Gibt die Formatvorlage für den Bereich an. Weitere Informationen finden Sie unter CBasePane::CreateEx.

pContext
[in, out] Gibt den Erstellungskontext für den Bereich an.

Rückgabewert

TRUE, wenn der Bereich erfolgreich erstellt wurde; andernfalls FALSE.

Hinweise

Diese Methode erstellt einen Windows-Bereich und fügt ihn an das CPane Objekt an.

Wenn Sie vor dem Aufruf CreateExnicht explizit CPane::m_recentDockInfo initialisiert haben, wird das Parameterrechteck beim Unverankerten oder Andocken des Bereichs als Rechteck verwendet.

CPane::D ockByMouse

Dockt einen Bereich mithilfe der Maus an.

virtual BOOL DockByMouse(CBasePane* pDockBar);

Parameter

pDockBar
[in] Gibt den Basisbereich an, an den dieser Bereich angedockt werden soll.

Rückgabewert

TRUE, wenn der Bereich erfolgreich angedockt wurde; andernfalls FALSE.

CPane::D ockPane

Dockt den unverankerten Bereich an einen Basisbereich an.

virtual BOOL DockPane(
    CBasePane* pDockBar,
    LPCRECT lpRect,
    AFX_DOCK_METHOD dockMethod);

Parameter

pDockBar
[in, out] Gibt den Basisbereich an, an den dieser Bereich angedockt werden soll.

lpRect
[in] Gibt das Rechteck im Basisbereich an, in dem dieser Bereich verankert werden soll.

dockMethod
[in] Gibt die zu verwendende Docking-Methode an. Verfügbare Optionen sind wie folgt:

Option Beschreibung
DM_UNKNOWN Das Framework verwendet diese Option, wenn die Dockingmethode unbekannt ist. Der Bereich speichert seine letzte unverankerte Position nicht. Sie können diese Option auch verwenden, um einen Bereich programmgesteuert anzudocken, wenn Sie die zuletzt unverankerte Position nicht speichern müssen.
DM_MOUSE Wird intern verwendet.
DM_DBL_CLICK Diese Option wird verwendet, wenn auf das Ziehelement doppelklickt wird. Der Bereich wird an seiner letzten Andockposition neu positioniert. Wenn der Bereich durch Doppelklicken abgedocken wird, wird der Bereich an seiner letzten unverankerten Position neu positioniert.
DM_SHOW Diese Option kann verwendet werden, um den Bereich programmgesteuert anzudocken. Der Bereich speichert seine letzte unverankerte Position.
DM_RECT Der Bereich ist in der Region verankert, die durch lpRect angegeben wird.
DM_STANDARD Wenn Sie diese Option verwenden, zeichnet das Framework den Bereich als Gliederungsrahmen, während es verschoben wird.

Rückgabewert

TRUE, wenn der Bereich erfolgreich angedockt wurde; andernfalls FALSE.

Hinweise

Mit dieser Methode wird der Bereich an den Basisbereich angedockt, der durch den pDockBar-Parameter angegeben wird. Sie müssen zuerst das Andocken aktivieren, indem Sie CBasePane::EnableDocking aufrufen.

CPane::D ockPaneStandard

Dockt einen Bereich mithilfe der Gliederung (Standard)-Andockung an.

virtual CPane* DockPaneStandard(BOOL& bWasDocked);

Parameter

bWasDocked
[in] TRUE, wenn der Bereich erfolgreich angedockt wurde; andernfalls FALSE.

Rückgabewert

Diese Methode gibt immer den this Zeiger zurück.

Hinweise

Diese Methode wird nur für Bereiche verwendet, die von der CDockablePane-Klasse abgeleitet werden. Weitere Informationen finden Sie unter CDockablePane::D ockPaneStandard.

CPane::D ockToFrameWindow

Dockt einen andockbaren Bereich an einen Frame an.

virtual BOOL DockToFrameWindow(
    DWORD dwAlignment,
    LPCRECT lpRect = NULL,
    DWORD dwDockFlags = DT_DOCK_LAST,
    CBasePane* pRelativeBar = NULL,
    int nRelativeIndex = -1,
    BOOL bOuterEdge = FALSE);

Parameter

dwAlignment
[in] Die Seite des übergeordneten Frames, an dem Sie den Bereich andocken möchten.

lpRect
[in] Die angegebene Größe.

dwDockFlags
[in] Ignoriert.

pRelativeBar
[in] Ignoriert.

nRelativeIndex
[in] Ignoriert.

bOuterEdge
[in] Wenn TRUE und andere andockbare Bereiche an der Seite vorhanden sind, die durch dwAlignment angegeben werden, wird der Bereich außerhalb der anderen Bereiche angedockt, näher am Rand des übergeordneten Frames. Wenn FALSE, wird der Bereich näher an der Mitte des Clientbereichs angedockt.

Rückgabewert

FALSE, wenn eine Bereichstrennlinie ( CPaneDivider-Klasse) nicht erstellt werden kann; andernfalls WAHR.

Hinweise

CPane::D oesAllowSiblingBars

Gibt an, ob Sie einen anderen Bereich an derselben Zeile andocken können, in der der aktuelle Bereich angedockt ist.

virtual BOOL DoesAllowSiblingBars() const;

Rückgabewert

TRUE, wenn dieser Bereich an einen anderen Bereich in derselben Zeile wie selbst andocken kann; andernfalls FALSE.

Hinweise

Sie können dieses Verhalten aktivieren oder deaktivieren, indem Sie CPane::SetExclusiveRowMode aufrufen.

Standardmäßig haben Symbolleisten den exklusiven Zeilenmodus deaktiviert, und die Menüleiste hat den exklusiven Zeilenmodus aktiviert.

CPane::FloatPane

Floats the pane.

virtual BOOL FloatPane(
    CRect rectFloat,
    AFX_DOCK_METHOD dockMethod = DM_UNKNOWN,
    bool bShow = true);

Parameter

rectFloat
[in] Gibt die Position in Bildschirmkoordinaten an, um den Bereich beim Gleiten zu positionieren.

dockMethod
[in] Gibt die Dockingmethode an, die beim Gleiten des Bereichs verwendet werden soll. Eine Liste der möglichen Werte finden Sie unter "CPane::D ockPane".

bShow
[in] TRUE, um den Bereich anzuzeigen, wenn er eingeblenbt wird; andernfalls FALSE.

Rückgabewert

TRUE, wenn der Bereich erfolgreich eingeflochten wurde oder wenn der Bereich nicht angezeigt werden kann, da CBasePane::CanFloat FALSE zurückgibt; andernfalls FALSE.

Hinweise

Rufen Sie diese Methode auf, um den Bereich an der Position anzuzeigen, die durch den rectFloat-Parameter angegeben wird. Diese Methode erstellt automatisch ein übergeordnetes Miniframefenster für den Bereich.

CPane::GetAvailableExpandSize

Gibt den Wert in Pixeln zurück, den der Bereich erweitern kann.

virtual int GetAvailableExpandSize() const;

Rückgabewert

Wenn der Bereich horizontal verankert ist, ist der Rückgabewert die verfügbare Breite; andernfalls ist der Rückgabewert die verfügbare Höhe.

Hinweise

CPane::GetAvailableStretchSize

Gibt den Wert in Pixeln zurück, den der Bereich verkleinern kann.

virtual int GetAvailableStretchSize() const;

Rückgabewert

Die Menge in Pixeln, die der Bereich verkleinern kann. Wenn der Bereich horizontal angedockt ist, ist dieser Betrag die verfügbare Breite; andernfalls ist sie die verfügbare Höhe.

Hinweise

Die verfügbare Stretchgröße wird berechnet, indem die zulässige Mindestgröße für den Bereich ( CPane::GetMinSize) von der aktuellen Größe ( CWnd::GetWindowRect) subtrahiert wird.

CPane::GetBorders

Gibt die Breite der Rahmen des Bereichs zurück.

CRect GetBorders() const;

Rückgabewert

Ein CRect-Objekt , das die aktuelle Breite in Pixeln jeder Seite des Bereichs enthält. Beispielsweise ist der Wert des left Elements des CRect Objekts die Breite des linken Rahmens.

Hinweise

Rufen Sie CPane::SetBorders auf, um die Größe der Rahmen festzulegen.

CPane::GetClientHotSpot

Gibt den Hotspot für den Bereich zurück.

CPoint GetClientHotSpot() const;

Rückgabewert

Bemerkungen

Der Hotspot ist der Punkt im Bereich, den der Benutzer auswählt und hält, um den Bereich zu verschieben. Ein Hotspot wird für reibungslose Animationen verwendet, wenn der Bereich von einer angedockten Position verschoben wird.

CPane::GetDockSiteRow

Gibt die Dockzeile ( CDockingPanesRow-Klasse) zurück, in der der Bereich angedockt ist.

CDockingPanesRow* GetDockSiteRow() const;

Rückgabewert

A CDockingPanesRow* that points to the dock row in which the pane is docked, or NULL if the pane is not docked.

CPane::GetExclusiveRowMode

Bestimmt, ob sich der Bereich im exklusiven Zeilenmodus befindet.

virtual BOOL GetExclusiveRowMode() const;

Rückgabewert

TRUE, wenn sich der Bereich im exklusiven Zeilenmodus befindet; andernfalls FALSE.

Hinweise

Weitere Informationen zum exklusiven Zeilenmodus finden Sie unter "CPane::SetExclusiveRowMode".

CPane::GetHotSpot

Gibt den Hotspot zurück, der in einem zugrunde liegenden CMFCDragFrameImpl Objekt gespeichert ist.

CPoint GetHotSpot() const;

Rückgabewert

Bemerkungen

Die CPane Klasse enthält ein CMFCDragFrameImpl Objekt, m_dragFrameImpldas für das Zeichnen des Rechtecks verantwortlich ist, das angezeigt wird, wenn der Benutzer einen Bereich im Standard-Docking-Modus verschiebt. Der Hotspot wird verwendet, um das Rechteck relativ zur aktuellen Mausposition zu zeichnen, während der Benutzer den Bereich bewegt.

CPane::GetMinSize

Ruft die minimale zulässige Größe für den Bereich ab.

virtual void GetMinSize(CSize& size) const;

Parameter

size
[out] Ein CSize Objekt, das mit der minimal zulässigen Größe gefüllt ist.

Hinweise

CPane::GetPaneName

Ruft den Titel für den Bereich ab.

virtual void GetPaneName(CString& strName) const;

Parameter

strName
[out] Ein CString Objekt, das mit dem Beschriftungsnamen gefüllt ist.

Hinweise

Der Bereichstitel wird im Beschriftungsbereich angezeigt, wenn der Bereich angedockt oder unverankert ist. Wenn der Bereich Teil einer Gruppe mit Registerkarten ist, wird der Titel im Registerkartenbereich angezeigt. Wenn sich der Bereich im Modus "Automatisch ausblenden" befindet, wird der Titel in einem CMFCAutoHideButton.

CPane::GetVirtualRect

Ruft das virtuelle Rechteck des Bereichs ab.

void GetVirtualRect(CRect& rectVirtual) const;

Parameter

rectVirtual
[out] Ein CRect Objekt, das mit dem virtuellen Rechteck gefüllt ist.

Hinweise

Wenn ein Bereich verschoben wird, speichert das Framework die ursprüngliche Position des Bereichs in einem virtuellen Rechteck. Das Framework kann das virtuelle Rechteck verwenden, um die ursprüngliche Position des Bereichs wiederherzustellen.

Rufen Sie keine Methoden auf, die sich auf virtuelle Rechtecke beziehen, es sei denn, Sie verschieben Bereiche programmgesteuert.

CPane::IsChangeState

Während der Bereich verschoben wird, analysiert diese Methode seine Position relativ zu anderen Bereichen, Dockzeilen und Miniframefenstern und gibt den entsprechenden AFX_CS_STATUS Wert zurück.

virtual AFX_CS_STATUS IsChangeState(
    int nOffset,
    CBasePane** ppTargetBar) const;

Parameter

nOffset
[in] Gibt die Andockempfindlichkeit an. Beispielsweise wird ein Bereich, der innerhalb von nOffset Pixel aus einer Dockzeile verschoben wird, angedockt.

ppTargetBar
[in] Wenn die Methode zurückgegeben wird, enthält ppTargetBar entweder einen Zeiger auf das Objekt, an das der aktuelle Bereich angedockt werden soll, oder NULL, wenn keine Andockung erfolgen soll.

Rückgabewert

Einer der folgenden AFX_CS_STATUS Werte:

Wert Beschreibung
CS_NOTHING Der Bereich befindet sich nicht in der Nähe eines Dockstandorts. Das Framework dockt den Bereich nicht an.
CS_DOCK_IMMEDIATELY Der Bereich befindet sich über einer Dockwebsite, und die DT_IMMEDIATE Formatvorlage ist aktiviert. Das Framework dockt den Bereich sofort an.
CS_DELAY_DOCK Der Bereich befindet sich über einem Dockstandort, der entweder ein anderer Andockbereich oder ein Rand des Hauptrahmens ist. Das Framework dockt den Bereich an, wenn der Benutzer die Verschiebung loslässt.
CS_DELAY_DOCK_TO_TAB Der Bereich befindet sich über einer Dockwebsite, die bewirkt, dass der Bereich in einem Registerkartenfenster angedockt wird. Dies tritt auf, wenn sich der Bereich entweder über der Beschriftung eines anderen Andockbereichs oder über dem Registerkartenbereich eines Registerkartenbereichs befindet. Das Framework dockt den Bereich an, wenn der Benutzer die Verschiebung loslässt.

CPane::IsDragMode

Gibt an, ob der Bereich verschoben wird.

virtual BOOL IsDragMode() const;

Rückgabewert

TRUE, wenn der Bereich verschoben wird; andernfalls FALSE.

Hinweise

CPane::IsInFloatingMultiPaneFrameWnd

Gibt an, ob sich der Bereich in einem Fenster mit mehreren Fensterausschnitten befindet ( CMultiPaneFrameWnd-Klasse).

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Rückgabewert

TRUE, wenn sich der Bereich in einem Fenster mit mehreren Fenstern befindet; andernfalls FALSE.

Hinweise

Nur andockbare Bereiche können in einem Fenster mit mehreren Fensterausschnitten schweben. CPane::IsInFloatingMultiPaneFrameWnd Gibt daher immer FALSE zurück.

CPane::IsLeftOf

Bestimmt, ob der Bereich links von (oder oberhalb) des angegebenen Rechtecks liegt.

bool IsLeftOf(
    CRect rect,
    bool bWindowRect = true) const;

Parameter

rect
[in] Ein CRect Objekt, das zum Vergleich verwendet wird.

bWindowRect
[in] Wenn WAHR, wird "rect " als Bildschirmkoordinaten angenommen. Wenn FALSE, wird "rect " als Clientkoordinaten angenommen.

Rückgabewert

Bemerkungen

Wenn der Bereich horizontal angedockt ist, überprüft diese Methode, ob seine Position links vom Rect liegt. Andernfalls überprüft diese Methode, ob sich der Speicherort oberhalb des Rechtecks befindet.

CPane::IsResizable

Gibt an, ob die Größe des Bereichs geändert werden kann.

virtual BOOL IsResizable() const;

Rückgabewert

TRUE, wenn die Größe des Bereichs geändert werden kann; andernfalls FALSE.

Hinweise

Basisobjekte CPane können nicht in der Größe geändert werden.

Der Docking-Manager verwendet das veränderbare Flag, um das Bereichslayout zu bestimmen. Nicht verkleinerbare Bereiche befinden sich immer an den äußeren Rändern des übergeordneten Frames.

Nicht verkleinerbare Bereiche können sich nicht in Andockcontainern befinden.

CPane::IsTabbed

Bestimmt, ob der Bereich in das Registersteuerelement eines Registerkartenfensters eingefügt wurde.

virtual BOOL IsTabbed() const;

Rückgabewert

TRUE, wenn der Bereich tabformatiert ist; andernfalls FALSE.

Hinweise

Der Zustand des Registerkartenformats wird getrennt von den unverankerten, angedockten und automatisch ausgeblendeten Zuständen behandelt.

CPane::LoadState

Lädt den Status des Bereichs aus der Registrierung.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT) -1);

Parameter

lpszProfileName
[in] Profilname.

nIndex
[in] Profilindex.

uiID
[in] Bereichs-ID.

Rückgabewert

TRUE, wenn der Bereichsstatus erfolgreich geladen wurde; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, um den Bereichsstatus aus der Registrierung zu laden. Überschreiben Sie sie in einer abgeleiteten Klasse, um zusätzliche Informationen zu laden, die von CPane::SaveState gespeichert werden.

Wenn Sie diese Methode überschreiben, rufen Sie auch die Basismethode auf und geben FALSE zurück, wenn die Basismethode FALSE zurückgibt.

CPane::m_bHandleMinSize

Ermöglicht eine konsistente Behandlung von Minimalbereichsgrößen.

AFX_IMPORT_DATA static BOOL m_bHandleMinSize;

Hinweise

Wenn ein oder mehrere Andockbereiche in Ihrer Anwendung außer Kraft GetMinSizegesetzt werden, oder wenn Ihre Anwendung aufruft SetMinSize, sollten Sie dieses statische Element auf TRUE festlegen, um das Framework so zu aktivieren, dass die Größe von Bereichen konsistent behandelt wird.

Wenn dieser Wert auf TRUE festgelegt ist, werden alle Bereiche, deren Größe unter der Mindestgröße verkleinert werden soll, nicht gestreckt. Da das Framework Fensterbereiche für Bereichsanpassungszwecke verwendet, ändern Sie nicht die Größe des Fensterbereichs für Andockbereiche, wenn dieser Wert auf TRUE festgelegt ist.

CPane::m_recentDockInfo

Enthält aktuelle Andockinformationen.

CRecentDockSiteInfo m_recentDockInfo;

Hinweise

Das Framework speichert die neuesten Andockstatusinformationen für den Bereich in diesem Member.

CPane::MoveByAlignment

Verschiebt den Bereich und das virtuelle Rechteck um den angegebenen Betrag.

BOOL MoveByAlignment(
    DWORD dwAlignment,
    int nOffset);

Parameter

dwAlignment
[in] Gibt die Bereichsausrichtung an.

nOffset
[in] Die Menge in Pixel, um die der Bereich und das virtuelle Rechteck verschoben werden soll.

Rückgabewert

Bemerkungen

dwAlignment kann eine der folgenden Werte sein:

Wert Beschreibung
CBRS_ALIGN_TOP Ermöglicht das Andocken des Bereichs am oberen Rand des Clientbereichs eines Framefensters.
CBRS_ALIGN_BOTTOM Ermöglicht das Andocken des Bereichs am unteren Rand des Clientbereichs eines Rahmenfensters.
CBRS_ALIGN_LEFT Ermöglicht das Andocken des Bereichs an die linke Seite des Clientbereichs eines Rahmenfensters.
CBRS_ALIGN_RIGHT Ermöglicht das Andocken des Bereichs an die rechte Seite des Clientbereichs eines Rahmenfensters.
CBRS_ALIGN_ANY Ermöglicht das Andocken des Bereichs an eine beliebige Seite des Clientbereichs eines Framefensters.

Wenn dwAlignment die CBRS_ALIGN_LEFT- oder CBRS_ALIGN_RIGHT-Kennzeichnung enthält, werden der Bereich und das virtuelle Rechteck horizontal verschoben. Andernfalls werden dwAlignment die CBRS_ALIGN_TOP- oder CBRS_ALIGN_BOTTOM-Kennzeichnung enthält, werden der Bereich und das virtuelle Rechteck vertikal verschoben.

CPane::MovePane

Verschiebt den Bereich zum angegebenen Rechteck.

virtual CSize MovePane(
    CRect rectNew,
    BOOL bForceMove,
    HDWP& hdwp);

Parameter

rectNew
[in] Gibt das neue Rechteck für den Bereich an.

bForceMove
[in] Wenn TRUE, ignoriert diese Methode die minimale zulässige Bereichsgröße ( CPane::GetMinSize). Andernfalls wird der Bereich bei Bedarf angepasst, um sicherzustellen, dass es mindestens die mindest zulässige Größe ist.

hdwp
[in] Wird nicht verwendet.

Rückgabewert

Ein CSize Objekt, das die Unterschiede zwischen Breite und Höhe zwischen den neuen und alten Rechtecken (altes Rechteck - RectNew) enthält.

Hinweise

Diese Methode wird nur für andockbare Bereiche verwendet.

CPane::OnAfterChangeParent

Wird vom Framework aufgerufen, wenn sich das übergeordnete Element eines Bereichs geändert hat.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Parameter

pWndOldParent
[in, out] Das vorherige übergeordnete Fenster des Bereichs.

Hinweise

Diese Methode wird vom Framework aufgerufen, wenn sich das übergeordnete Element eines Bereichs aufgrund eines Andockvorgangs oder eines unverankerten Vorgangs geändert hat.

CPane::OnAfterDock

Wird vom Framework aufgerufen, wenn ein Bereich angedockt wurde.

virtual void OnAfterDock(
    CBasePane* pBar,
    LPCRECT lpRect,
    AFX_DOCK_METHOD dockMethod);

Parameter

pBar
[in] Dieser Parameter wird nicht verwendet.

lpRect
[in] Dieser Parameter wird nicht verwendet.

dockMethod
[in] Dieser Parameter wird nicht verwendet.

CPane::OnAfterFloat

Wird vom Framework aufgerufen, nachdem ein Bereich schwebt.

virtual void OnAfterFloat();

Hinweise

Sie können diese Methode in einer abgeleiteten Klasse überschreiben, wenn Sie eine Verarbeitung nach einem Bereich ausführen möchten.

CPane::OnBeforeChangeParent

Wird vom Framework aufgerufen, wenn sich das übergeordnete Element des Bereichs ändert.

virtual void OnBeforeChangeParent(
    CWnd* pWndNewParent,
    BOOL bDelay = FALSE);

Parameter

pWndNewParent
[in, out] Gibt das neue übergeordnete Fenster an.

bDelay
[in] TRUE, um die Anpassung des globalen Andocklayouts zu verzögern; andernfalls FALSE.

Hinweise

Diese Methode wird vom Framework aufgerufen, wenn sich das übergeordnete Element des Bereichs ändert, da der Bereich angedockt oder schwebt.

Standardmäßig wird die Registrierung des Bereichs mit dem Andockbereich durch Aufrufen CDockSite::RemovePaneaufgehoben.

CPane::OnBeforeDock

Wird vom Framework aufgerufen, wenn der Bereich gerade andocken soll.

virtual BOOL OnBeforeDock(
    CBasePane** ppDockBar,
    LPCRECT lpRect,
    AFX_DOCK_METHOD dockMethod);

Parameter

ppDockBar
[in, out] Gibt den Bereich an, an den dieser Bereich andockt.

lpRect
[in] Gibt das Andockrechteck an.

dockMethod
[in] Gibt die Docking-Methode an.

Rückgabewert

TRUE, wenn der Bereich angedockt werden kann. Wenn die Funktion FALSE zurückgibt, wird der Andockvorgang abgebrochen.

Hinweise

Diese Methode wird vom Framework aufgerufen, wenn ein Bereich angedockt werden soll. Sie können diese Methode in einer abgeleiteten Klasse überschreiben, wenn Sie eine Verarbeitung durchführen möchten, bevor ein Bereich schließlich angedockt wird.

CPane::OnBeforeFloat

Wird vom Framework aufgerufen, wenn ein Bereich in der Zeit zum Gleiten ist.

virtual BOOL OnBeforeFloat(
    CRect& rectFloat,
    AFX_DOCK_METHOD dockMethod);

Parameter

rectFloat
[in] Gibt die Position und Größe des Bereichs an, wenn er sich in einem unverankerten Zustand befindet.

dockMethod
[in] Gibt die Andockmethode des Bereichs an.

Rückgabewert

TRUE, wenn der Bereich eingefloben werden kann; andernfalls FALSE.

Hinweise

Diese Methode wird vom Framework aufgerufen, wenn ein Bereich im Hinblick auf den Gleitkommabereich angezeigt wird. Sie können diese Methode in einer abgeleiteten Klasse überschreiben, wenn Sie eine Verarbeitung durchführen möchten, bevor der Bereich schließlich schwebt.

CPane::OnPressCloseButton

Wird vom Framework aufgerufen, wenn der Benutzer die Schaltfläche "Schließen" auf der Beschriftung für den Bereich drückt.

virtual void OnPressCloseButton();

Hinweise

Diese Methode wird vom Framework aufgerufen, wenn ein Benutzer die Schaltfläche "Schließen " auf der Beschriftung des Bereichs drückt. Um Benachrichtigungen über das Close-Ereignis zu erhalten, können Sie diese Methode in einer abgeleiteten Klasse überschreiben.

CPane::OnShowControlBarMenu

Wird von Framework aufgerufen, kurz bevor ein spezielles Bereichsmenü angezeigt wird.

virtual BOOL OnShowControlBarMenu(CPoint point);

Parameter

Punkt
[in] Gibt den Menüspeicherort an.

Rückgabewert

TRUE, wenn das Menü angezeigt werden kann; andernfalls FALSE.

Hinweise

Das Menü enthält mehrere Elemente, mit denen Sie das Verhalten des Bereichs angeben können, nämlich: Unverankert, Andocken, AutoHide und Ausblenden. Sie können dieses Menü für alle Bereiche aktivieren, indem Sie CDockingManager::EnableDockSiteMenu aufrufen.

CPane::RecalcLayout

Berechnet Layoutinformationen für den Bereich neu.

virtual void RecalcLayout();

Hinweise

Wenn der Bereich angedockt ist, aktualisiert diese Methode das virtuelle Rechteck für den Bereich, indem seine Größe auf die aktuelle Größe des Bereichs festgelegt wird.

Wenn der Bereich unverankert ist, benachrichtigt diese Methode den übergeordneten Miniframe, um die Größe des Bereichs an die Größe des Miniframes anzupassen. Das Framework stellt sicher, dass der Miniframe mindestens die mindest zulässige Größe für den Bereich ( CPane::GetMinSize) ist und bei Bedarf die Größe des Miniframes ändert.

CPane::SaveState

Speichert den Status des Bereichs in der Registrierung.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT) -1);

Parameter

lpszProfileName
[in] Profilname.

nIndex
[in] Profilindex.

uiID
[in] Bereichs-ID.

Rückgabewert

TRUE, wenn der Zustand erfolgreich gespeichert wurde; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, wenn der Status des Bereichs in der Registrierung gespeichert wird. Überschreiben SaveState sie in einer abgeleiteten Klasse, um zusätzliche Informationen zu speichern.

Wenn Sie diese Methode überschreiben, rufen Sie auch die Basismethode auf und geben FALSE zurück, wenn die Basismethode FALSE zurückgibt.

CPane::SetActiveInGroup

Kennzeichnet einen Bereich als aktiv.

virtual void SetActiveInGroup(BOOL bActive);

Parameter

bActive
[in] Ein BOOL, der angibt, ob der Bereich als aktiv gekennzeichnet ist.

Hinweise

Wenn ein andockbarer Bereich angezeigt wird oder eine Schaltfläche zum automatischen Ausblenden ausgewählt wird, wird der entsprechende Bereich für das automatische Ausblenden als aktiv markiert.

Die Darstellung einer Schaltfläche zum automatischen Ausblenden, die dem Bereich zugeordnet ist, basiert auf zwei Faktoren. Wenn der Bereich aktiv ist und wahr static BOOL CMFCAutoHideButton::m_bOverlappingTabs ist, zeigt das Framework die Schaltfläche zum automatischen Ausblenden als Symbol und eine Beschriftung an. Für einen inaktiven Bereich zeigt das Framework nur das Symbol zum automatischen Ausblenden an.

Ist CMFCAutoHideButton::m_bOverlappingTabs FALSE oder befindet sich der Bereich nicht in einer Gruppe, zeigt das Framework die zugeordnete Schaltfläche zum automatischen Ausblenden als Symbol und beschriftung an.

CPane::SetBorders

Legt die Rahmenwerte des Bereichs fest.

void SetBorders(
    int cxLeft = 0,
    int cyTop = 0,
    int cxRight = 0,
    int cyBottom = 0);

void SetBorders(LPCRECT lpRect);

Parameter

cxLeft
[in] Gibt die Breite des linken Rands des Bereichs in Pixel an.

cyTop
[in] Gibt die Breite des oberen Rands des Bereichs in Pixel an.

cxRight
[in] Gibt die Breite des rechten Rahmens des Bereichs in Pixeln an.

cyBottom
[in] Gibt die Breite des unteren Rahmens des Bereichs in Pixel an.

lpRect
[in] Ein CRect-Objekt , das die Breite jedes Rahmens des Bereichs in Pixeln enthält.

Hinweise

Rufen Sie diese Funktion auf, um die Größen der Rahmen des Bereichs festzulegen.

CPane::SetClientHotSpot

Legt den Hotspot für den Bereich fest.

void SetClientHotSpot(const CPoint& ptNew);

Parameter

ptNew
[in] Ein CPoint Objekt, das den neuen Hotspot angibt.

Hinweise

Der Hotspot ist der Punkt im Bereich, den der Benutzer auswählt und hält, um den Bereich zu verschieben. Ein Hotspot wird für reibungslose Animationen verwendet, wenn der Bereich von einer angedockten Position gezogen wird.

CPane::SetDockState

Stellt Die Andockstatusinformationen für den Bereich wieder her.

virtual void SetDockState(CDockingManager* pDockManager);

Parameter

pDockManager
[in] Zeigen Sie auf den Docking-Manager für das Hauptrahmenfenster.

Hinweise

Diese Methode wird vom Framework aufgerufen, um aktuelle Andockstatusinformationen für den Bereich wiederherzustellen. In einem Bereich werden die aktuellen Andockstatusinformationen in CPane::m_recentDockInfo gespeichert. Weitere Informationen finden Sie unter der CRecentDockSiteInfo-Klasse.

Sie können diese Methode auch aufrufen, um den Andockzustand festzulegen, wenn Sie Bereichsinformationen aus einer externen Quelle laden.

CPane::SetExclusiveRowMode

Aktiviert oder deaktiviert den exklusiven Zeilenmodus.

virtual void SetExclusiveRowMode(BOOL bExclusive = TRUE);

Parameter

bExclusive
[in] TRUE, um den exklusiven Zeilenmodus zu aktivieren; andernfalls FALSE.

Hinweise

Rufen Sie diese Methode auf, um den exklusiven Zeilenmodus zu aktivieren oder zu deaktivieren. Wenn sich ein Bereich im exklusiven Zeilenmodus befindet, kann er nicht dieselbe Zeile mit anderen Symbolleisten teilen.

Standardmäßig sind alle Symbolleisten im exklusiven Zeilenmodus deaktiviert, und die Menüleiste hat den exklusiven Zeilenmodus aktiviert.

CPane::SetMinSize

Legt die minimale zulässige Größe für den Bereich fest.

void SetMinSize(const CSize& size);

Parameter

size
[in] Ein CSize Objekt, das die minimale zulässige Größe für den Bereich enthält.

Hinweise

CPane::SetVirtualRect

Legt das virtuelle Rechteck des Bereichs fest.

void SetVirtualRect(
    const CRect& rect,
    BOOL bMapToParent = TRUE);

Parameter

rect
[in] Ein CRect Objekt, das das festzulegende virtuelle Rechteck angibt.

bMapToParent
[in] Geben Sie WAHR an, wenn das Rechteck Punkte relativ zum übergeordneten Fenster enthält.

Hinweise

Ein virtuelles Rechteck speichert die ursprüngliche Position eines Bereichs, wenn es verschoben wird. Das Framework kann das virtuelle Rechteck verwenden, um die ursprüngliche Position wiederherzustellen.

Rufen Sie keine Methoden auf, die sich auf virtuelle Rechtecke beziehen, es sei denn, Sie verschieben Bereiche programmgesteuert.

CPane::SetMiniFrameRTC

Legt die Laufzeitklasseninformationen für das Standardmäßige Miniframefenster fest.

void SetMiniFrameRTC(CRuntimeClass* pClass);

Parameter

pClass
[in, out] Gibt die Laufzeitklasseninformationen für das Miniframefenster an.

Hinweise

Wenn ein Bereich schwebt, wird er in einem CPaneFrameWnd-Fenster (Miniframe) platziert. Sie können eine benutzerdefinierte CPaneFrameWndabgeleitete Klasse bereitstellen, die verwendet wird, wenn CPane::CreateDefaultMiniframe aufgerufen wird.

CPane::StretchPaneDeferWndPos

Gestreckt den Bereich vertikal oder horizontal basierend auf dem Andockstil.

virtual int StretchPaneDeferWndPos(
    int nStretchSize,
    HDWP& hdwp);

Parameter

nStretchSize
[in] Die Menge in Pixeln, um den Bereich zu strecken. Verwenden Sie einen negativen Wert, um den Bereich zu verkleinern.

hdwp
[in] Wird nicht verwendet.

Rückgabewert

Der tatsächliche Wert in Pixeln, den der Bereich gestreckt hat.

Hinweise

Bei Bedarf ändert diese Methode nStretchSize , um sicherzustellen, dass der Bereich keine Größenbeschränkungen überschreitet. Diese Grenzwerte werden durch Aufrufen von CPane::GetAvailableStretchSize und CPane::GetAvailableExpandSize abgerufen.

CPane::ToggleAutoHide

Schaltet den Modus zum automatischen Ausblenden um.

virtual void ToggleAutoHide();

Hinweise

Rufen Sie diese Methode auf, um den Modus zum automatischen Ausblenden zu aktivieren. Ein Bereich muss an ein Hauptrahmenfenster angedockt werden, um zum automatischen Ausblenden zu wechseln.

CPane::UndockPane

Entfernt den Bereich von der Dockwebsite, dem Standardschieberegler oder dem Miniframefenster, in dem er derzeit verankert ist.

virtual void UndockPane(BOOL bDelay = FALSE);

Parameter

bDelay
[in] Wenn FALSE, ruft das Framework CBasePane::AdjustDockingLayout auf, um das Andocklayout anzupassen.

Hinweise

Verwenden Sie diese Methode, um einen Bereich programmgesteuert rückgängig zu machen.

CPane::UpdateVirtualRect

Aktualisiert das virtuelle Rechteck.

void UpdateVirtualRect();
void UpdateVirtualRect(CPoint ptOffset);
void UpdateVirtualRect(CSize sizeNew);

Parameter

ptOffset
[in] Ein CPoint Objekt, das einen Offset angibt, um den Bereich zu verschieben.

sizeNew
[in] Ein CSize Objekt, das eine neue Größe für den Bereich angibt.

Hinweise

Die erste Überladung legt das virtuelle Rechteck mithilfe der aktuellen Position und Größe des Bereichs fest.

Die zweite Überladung verschiebt das virtuelle Rechteck um den durch ptOffset angegebenen Betrag.

Die dritte Überladung legt das virtuelle Rechteck mithilfe der aktuellen Position des Bereichs und der Größe fest, die durch sizeNew angegeben wird.

Siehe auch

Hierarchiediagramm
Klassen
CBasePane-Klasse