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

Öffentliche Methoden

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

Hinweise

CPaneContainer::AddRef

void AddRef();

Hinweise

CPaneContainer::AddSubPaneContainer

BOOL AddSubPaneContainer(
    CPaneContainer* pContainer,
    BOOL bRightNodeNew);

Parameter

[in] pContainer
[in] bRightNodeNew

Rückgabewert

Hinweise

CPaneContainer::CalcAvailablePaneSpace

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

Parameter

[in] nRequiredOffset
[in] Pbar
[in] pContainer
[in] bLeftBar

Rückgabewert

Hinweise

CPaneContainer::CalcAvailableSpace

virtual CSize CalcAvailableSpace(
    CSize sizeStretch,
    BOOL bLeftBar);

Parameter

[in] sizeStretch
[in] bLeftBar

Rückgabewert

Hinweise

CPaneContainer::CalculateRecentSize

void CalculateRecentSize();

Hinweise

CPaneContainer::CheckPaneDividerVisibility

void CheckPaneDividerVisibility();

Hinweise

CPaneContainer::Copy

virtual CPaneContainer* Copy(CPaneContainer* pParentContainer);

Parameter

[in] pParentContainer

Rückgabewert

Hinweise

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

Hinweise

CPaneContainer::FindTabbedPane

CDockablePane* FindTabbedPane(UINT nID);

Parameter

[in] Nid

Rückgabewert

Hinweise

CPaneContainer::GetAssociatedSiblingPaneIDs

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

Parameter

[in] Pbar

Rückgabewert

Hinweise

CPaneContainer::GetLeftPane

const CDockablePane* GetLeftPane() const;

Rückgabewert

Hinweise

CPaneContainer::GetLeftPaneContainer

const CPaneContainer* GetLeftPaneContainer() const;

Rückgabewert

Hinweise

CPaneContainer::GetMinSize

virtual void GetMinSize(CSize& size) const;

Parameter

[in] Größe

Hinweise

CPaneContainer::GetMinSizeLeft

virtual void GetMinSizeLeft(CSize& size) const;

Parameter

[in] Größe

Hinweise

CPaneContainer::GetMinSizeRight

virtual void GetMinSizeRight(CSize& size) const;

Parameter

[in] Größe

Hinweise

CPaneContainer::GetNodeCount

int GetNodeCount() const;

Rückgabewert

Hinweise

CPaneContainer::GetPaneDivider

const CPaneDivider* GetPaneDivider() const;

Rückgabewert

Hinweise

CPaneContainer::GetParentPaneContainer

CPaneContainer* GetParentPaneContainer() const;

Rückgabewert

Hinweise

CPaneContainer::GetRecentPaneDividerRect

CRect GetRecentPaneDividerRect() const;

Rückgabewert

Hinweise

CPaneContainer::GetRecentPaneDividerStyle

DWORD GetRecentPaneDividerStyle() const;

Rückgabewert

Hinweise

CPaneContainer::GetRecentPercent

int GetRecentPercent();

Rückgabewert

Hinweise

CPaneContainer::GetRefCount

LONG GetRefCount();

Rückgabewert

Hinweise

CPaneContainer::GetResizeStep

virtual int GetResizeStep() const;

Rückgabewert

Hinweise

CPaneContainer::GetRightPane

const CDockablePane* GetRightPane() const;

Rückgabewert

Hinweise

CPaneContainer::GetRightPaneContainer

const CPaneContainer* GetRightPaneContainer() const;

Rückgabewert

Hinweise

CPaneContainer::GetTotalReferenceCount

int GetTotalReferenceCount() const;

Rückgabewert

Hinweise

CPaneContainer::GetWindowRect

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

Parameter

[in] Rect
[in] bIgnoreVisibility

Hinweise

CPaneContainer::IsDisposed

BOOL IsDisposed() const;

Rückgabewert

Hinweise

CPaneContainer::IsEmpty

BOOL IsEmpty() const;

Rückgabewert

Hinweise

CPaneContainer::IsLeftPane

BOOL IsLeftPane(CDockablePane* pBar) const;

Parameter

[in] Pbar

Rückgabewert

Hinweise

CPaneContainer::IsLeftPaneContainer

BOOL IsLeftPaneContainer() const;

Rückgabewert

Hinweise

CPaneContainer::IsLeftPartEmpty

BOOL IsLeftPartEmpty(BOOL bCheckVisibility = FALSE) const;

Parameter

[in] bCheckVisibility

Rückgabewert

Hinweise

CPaneContainer::IsRightPartEmpty

BOOL IsRightPartEmpty(BOOL bCheckVisibility = FALSE) const;

Parameter

[in] bCheckVisibility

Rückgabewert

Hinweise

CPaneContainer::IsVisible

BOOL IsVisible() const;

Rückgabewert

Hinweise

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

Hinweise

CPaneContainer::OnShowPane

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

Parameter

[in] Pbar
[in] bShow

Hinweise

CPaneContainer::Release

DWORD Release();

Rückgabewert

Hinweise

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] nRecentPercentPercent

Hinweise

CPaneContainer::SetUpByID

BOOL SetUpByID(
    UINT nID,
    CDockablePane* pBar);

Parameter

[in] Nid
[in] Pbar

Rückgabewert

Hinweise

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

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CObject-Klasse
CPaneContainerManager-Klasse