CPaneContainer-Klasse

Die CPaneContainer-Klasse ist eine grundlegende Komponente des von MFC implementierten Andockmodells. Ein Objekt dieser Klasse speichert Zeiger auf zwei Andockbereiche oder auf zwei Instanzen von CPaneContainer. Außerdem wird ein Zeiger auf den Divider gespeichert, der die Bereiche (oder die Container) voneinander trennt. Durch das Verschachteln von Containern ineinander kann das Framework eine binären Struktur erstellen, die komplexe Andocklayouts darstellt. Der Stamm der binären Struktur befindet sich in einem CPaneContainerManager-Objekt.

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Syntax

class CPaneContainer : public CObject

Member

Öffentliche Konstruktoren

Name Beschreibung
CPaneContainer::CPaneContainer Der Standardkonstruktor.

Öffentliche Methoden

Name Beschreibung
CPaneContainer::AddPane
CPaneContainer::AddRef
CPaneContainer::AddSubPaneContainer
CPaneContainer::CalcAvailablePaneSpace
CPaneContainer::CalcAvailableSpace
CPaneContainer::CalculateRecentSize
CPaneContainer::CheckPaneDividerVisibility
CPaneContainer::Copy
CPaneContainer::DeletePane
CPaneContainer::FindSubPaneContainer
CPaneContainer::FindTabbedPane
CPaneContainer::GetAssociatedSiblingPaneIDs
CPaneContainer::GetLeftPane
CPaneContainer::GetLeftPaneContainer
CPaneContainer::GetMinSize
CPaneContainer::GetMinSizeLeft
CPaneContainer::GetMinSizeRight
CPaneContainer::GetNodeCount
CPaneContainer::GetPaneDivider
CPaneContainer::GetParentPaneContainer
CPaneContainer::GetRecentPaneDividerRect
CPaneContainer::GetRecentPaneDividerStyle
CPaneContainer::GetRecentPercent
CPaneContainer::GetRefCount
CPaneContainer::GetResizeStep
CPaneContainer::GetRightPane
CPaneContainer::GetRightPaneContainer
CPaneContainer::GetTotalReferenceCount
CPaneContainer::GetWindowRect
CPaneContainer::IsDisposed
CPaneContainer::IsEmpty
CPaneContainer::IsLeftPane
CPaneContainer::IsLeftPaneContainer
CPaneContainer::IsLeftPartEmpty
CPaneContainer::IsRightPartEmpty
CPaneContainer::IsVisible
CPaneContainer::Move
CPaneContainer::OnDeleteHidePane
CPaneContainer::OnMoveInternalPaneDivider
CPaneContainer::OnShowPane
CPaneContainer::Release
CPaneContainer::ReleaseEmptyPaneContainer
CPaneContainer::RemoveNonValidPanes
CPaneContainer::RemovePane
CPaneContainer::Resize
CPaneContainer::ResizePane
CPaneContainer::ResizePartOfPaneContainer
CPaneContainer::Serialize Liest oder schreibt dieses Objekt aus einem oder in ein Archiv. (Überschreibt CObject::Serialize.)
CPaneContainer::SetPane
CPaneContainer::SetPaneContainer
CPaneContainer::SetPaneDivider
CPaneContainer::SetParentPaneContainer
CPaneContainer::SetRecentPercent
CPaneContainer::SetUpByID
CPaneContainer::StoreRecentDockSiteInfo
CPaneContainer::StretchPaneContainer

Hinweise

CPaneContainer-Objekte werden automatisch vom Framework erstellt.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie eine Instanz der CPaneContainer-Klasse erstellt wird. Dieser Codeschnipsel ist Teil des Beispiels „Festlegen der Bereichsgröße“.

CPaneDialog m_wndDlgBar;
CPaneDivider *pDefaultPaneDivider = m_wndDlgBar.GetDefaultPaneDivider();
if (pDefaultPaneDivider == NULL)
{
   AfxMessageBox(_T ("The DialogBar is not docked."));
   return;
}

BOOL bLeftBar = FALSE;
CPaneContainer *pContainer = pDefaultPaneDivider->FindPaneContainer(&m_wndDlgBar, bLeftBar);

Vererbungshierarchie

CObject

CPaneContainer

Anforderungen

Header: afxpanecontainer.h

CPaneContainer::AddPane

CDockablePane* AddPane(CDockablePane* pBar);

Parameter

[in] pBar

Rückgabewert

Bemerkungen

CPaneContainer::AddRef

void AddRef();

Hinweise

CPaneContainer::AddSubPaneContainer

BOOL AddSubPaneContainer(
    CPaneContainer* pContainer,
    BOOL bRightNodeNew);

Parameter

[in] pContainer
[in] bRightNodeNew

Rückgabewert

Bemerkungen

CPaneContainer::CalcAvailablePaneSpace

virtual int CalcAvailablePaneSpace(
    int nRequiredOffset,
    CPane* pBar,
    CPaneContainer* pContainer,
    BOOL bLeftBar);

Parameter

[in] nRequiredOffset
[in] pBar
[in] pContainer
[in] bLeftBar

Rückgabewert

Bemerkungen

CPaneContainer::CalcAvailableSpace

virtual CSize CalcAvailableSpace(
    CSize sizeStretch,
    BOOL bLeftBar);

Parameter

[in] sizeStretch
[in] bLeftBar

Rückgabewert

Bemerkungen

CPaneContainer::CalculateRecentSize

void CalculateRecentSize();

Hinweise

CPaneContainer::CheckPaneDividerVisibility

void CheckPaneDividerVisibility();

Hinweise

CPaneContainer::Copy

virtual CPaneContainer* Copy(CPaneContainer* pParentContainer);

Parameter

[in] pParentContainer

Rückgabewert

Bemerkungen

CPaneContainer::CPaneContainer

CPaneContainer(
    CPaneContainerManager* pManager = NULL,
    CDockablePane* pLeftBar = NULL,
    CDockablePane* pRightBar = NULL,
    CPaneDivider* pSlider = NULL);

Parameter

[in] pManager
[in] pLeftBar
[in] pRightBar
[in] pSlider

Hinweise

CPaneContainer::DeletePane

virtual void DeletePane(
    CDockablePane* pBar,
    BC_FIND_CRITERIA barType);

Parameter

[in] pBar
[in] barType

Hinweise

CPaneContainer::FindSubPaneContainer

CPaneContainer* FindSubPaneContainer(
    const CObject* pObject,
    BC_FIND_CRITERIA findCriteria);

Parameter

[in] pObject
[in] findCriteria

Rückgabewert

Bemerkungen

CPaneContainer::FindTabbedPane

CDockablePane* FindTabbedPane(UINT nID);

Parameter

[in] nID

Rückgabewert

Bemerkungen

CPaneContainer::GetAssociatedSiblingPaneIDs

CList<UINT, UINT>* GetAssociatedSiblingPaneIDs(CDockablePane* pBar);

Parameter

[in] pBar

Rückgabewert

Bemerkungen

CPaneContainer::GetLeftPane

const CDockablePane* GetLeftPane() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetLeftPaneContainer

const CPaneContainer* GetLeftPaneContainer() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetMinSize

virtual void GetMinSize(CSize& size) const;

Parameter

[in] size

Hinweise

CPaneContainer::GetMinSizeLeft

virtual void GetMinSizeLeft(CSize& size) const;

Parameter

[in] size

Hinweise

CPaneContainer::GetMinSizeRight

virtual void GetMinSizeRight(CSize& size) const;

Parameter

[in] size

Hinweise

CPaneContainer::GetNodeCount

int GetNodeCount() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetPaneDivider

const CPaneDivider* GetPaneDivider() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetParentPaneContainer

CPaneContainer* GetParentPaneContainer() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetRecentPaneDividerRect

CRect GetRecentPaneDividerRect() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetRecentPaneDividerStyle

DWORD GetRecentPaneDividerStyle() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetRecentPercent

int GetRecentPercent();

Rückgabewert

Bemerkungen

CPaneContainer::GetRefCount

LONG GetRefCount();

Rückgabewert

Bemerkungen

CPaneContainer::GetResizeStep

virtual int GetResizeStep() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetRightPane

const CDockablePane* GetRightPane() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetRightPaneContainer

const CPaneContainer* GetRightPaneContainer() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetTotalReferenceCount

int GetTotalReferenceCount() const;

Rückgabewert

Bemerkungen

CPaneContainer::GetWindowRect

virtual void GetWindowRect(
    CRect& rect,
    BOOL bIgnoreVisibility = FALSE) const;

Parameter

[in] rect
[in] bIgnoreVisibility

Hinweise

CPaneContainer::IsDisposed

BOOL IsDisposed() const;

Rückgabewert

Bemerkungen

CPaneContainer::IsEmpty

BOOL IsEmpty() const;

Rückgabewert

Bemerkungen

CPaneContainer::IsLeftPane

BOOL IsLeftPane(CDockablePane* pBar) const;

Parameter

[in] pBar

Rückgabewert

Bemerkungen

CPaneContainer::IsLeftPaneContainer

BOOL IsLeftPaneContainer() const;

Rückgabewert

Bemerkungen

CPaneContainer::IsLeftPartEmpty

BOOL IsLeftPartEmpty(BOOL bCheckVisibility = FALSE) const;

Parameter

[in] bCheckVisibility

Rückgabewert

Bemerkungen

CPaneContainer::IsRightPartEmpty

BOOL IsRightPartEmpty(BOOL bCheckVisibility = FALSE) const;

Parameter

[in] bCheckVisibility

Rückgabewert

Bemerkungen

CPaneContainer::IsVisible

BOOL IsVisible() const;

Rückgabewert

Bemerkungen

CPaneContainer::Move

virtual void Move(CPoint ptNewLeftTop);

Parameter

[in] ptNewLeftTop

Hinweise

CPaneContainer::OnDeleteHidePane

void OnDeleteHidePane(
    CDockablePane* pBar,
    BOOL bHide);

Parameter

[in] pBar
[in] bHide

Hinweise

CPaneContainer::OnMoveInternalPaneDivider

virtual int OnMoveInternalPaneDivider(
    int nOffset,
    HDWP& hdwp);

Parameter

[in] nOffset
[in] hdwp

Rückgabewert

Bemerkungen

CPaneContainer::OnShowPane

virtual void OnShowPane(
    CDockablePane* pBar,
    BOOL bShow);

Parameter

[in] pBar
[in] bShow

Hinweise

CPaneContainer::Release

DWORD Release();

Rückgabewert

Bemerkungen

CPaneContainer::ReleaseEmptyPaneContainer

void ReleaseEmptyPaneContainer();

Hinweise

CPaneContainer::RemoveNonValidPanes

void RemoveNonValidPanes();

Hinweise

CPaneContainer::RemovePane

virtual void RemovePane(CDockablePane* pBar);

Parameter

[in] pBar

Hinweise

CPaneContainer::Resize

virtual void Resize(
    CRect rect,
    HDWP& hdwp,
    BOOL bRedraw = FALSE);

Parameter

[in] rect
[in] hdwp
[in] bRedraw

Hinweise

CPaneContainer::ResizePane

virtual void ResizePane(
    int nOffset,
    CPane* pBar,
    CPaneContainer* pContainer,
    BOOL bHorz,
    BOOL bLeftBar,
    HDWP& hdwp);

Parameter

[in] nOffset
[in] pBar
[in] pContainer
[in] bHorz
[in] bLeftBar
[in] hdwp

Hinweise

CPaneContainer::ResizePartOfPaneContainer

virtual void ResizePartOfPaneContainer(
    int nOffset,
    BOOL bLeftPart,
    HDWP& hdwp);

Parameter

[in] nOffset
[in] bLeftPart
[in] hdwp

Hinweise

CPaneContainer::Serialize

void Serialize(CArchive& ar);

Parameter

[in] ar

Hinweise

CPaneContainer::SetPane

void SetPane(
    CDockablePane* pBar,
    BOOL bLeft);

Parameter

[in] pBar
[in] bLeft

Hinweise

CPaneContainer::SetPaneContainer

void SetPaneContainer(
    CPaneContainer* pContainer,
    BOOL bLeft);

Parameter

[in] pContainer
[in] bLeft

Hinweise

CPaneContainer::SetPaneDivider

void SetPaneDivider(CPaneDivider* pSlider);

Parameter

[in] pSlider

Hinweise

CPaneContainer::SetParentPaneContainer

void SetParentPaneContainer(CPaneContainer* p);

Parameter

[in] p

Hinweise

CPaneContainer::SetRecentPercent

void SetRecentPercent(int nRecentPercent);

Parameter

[in] nRecentPercent

Hinweise

CPaneContainer::SetUpByID

BOOL SetUpByID(
    UINT nID,
    CDockablePane* pBar);

Parameter

[in] nID
[in] pBar

Rückgabewert

Bemerkungen

CPaneContainer::StoreRecentDockSiteInfo

virtual void StoreRecentDockSiteInfo(CDockablePane* pBar);

Parameter

[in] pBar

Hinweise

CPaneContainer::StretchPaneContainer

virtual int StretchPaneContainer(
    int nOffset,
    BOOL bStretchHorz,
    BOOL bLeftBar,
    BOOL bMoveSlider,
    HDWP& hdwp);

Parameter

[in] nOffset
[in] bStretchHorz
[in] bLeftBar
[in] bMoveSlider
[in] hdwp

Rückgabewert

Bemerkungen

Weitere Informationen

Hierarchiediagramm
Klassen
CObject-Klasse
CPaneContainerManager-Klasse