Compartilhar via


Classe CPaneContainer

A classe CPaneContainer é um componente básico do modelo de encaixe implementado pelo MFC. Um objeto dessa classe armazena ponteiros para dois painéis de encaixe ou para duas instâncias de CPaneContainer. Também armazena um ponteiro para o divisor que separa os painéis (ou os contêineres). Ao aninhar contêineres dentro de contêineres, a estrutura pode criar uma árvore binária que representa layouts de encaixe complexos. A raiz da árvore binária é armazenada em um objeto CPaneContainerManager.

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Sintaxe

class CPaneContainer : public CObject

Membros

Construtores públicos

Nome Descrição
CPaneContainer::CPaneContainer Construtor padrão.

Métodos públicos

Nome Descrição
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 Lê ou grava esse objeto de ou em uma camada de arquivos. (Substitui CObject::Serialize.)
CPaneContainer::SetPane
CPaneContainer::SetPaneContainer
CPaneContainer::SetPaneDivider
CPaneContainer::SetParentPaneContainer
CPaneContainer::SetRecentPercent
CPaneContainer::SetUpByID
CPaneContainer::StoreRecentDockSiteInfo
CPaneContainer::StretchPaneContainer

Comentários

Os objetos CPaneContainer são criados automaticamente pela estrutura.

Exemplo

O exemplo a seguir demonstra como construir uma instância da classe CPaneContainer. Esse snippet de código faz parte do exemplo Definir Tamanho do Painel.

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);

Hierarquia de herança

CObject

CPaneContainer

Requisitos

Cabeçalho: afxpanecontainer.h

CPaneContainer::AddPane

CDockablePane* AddPane(CDockablePane* pBar);

Parâmetros

[in] pBar

Valor de retorno

Comentários

CPaneContainer::AddRef

void AddRef();

Comentários

CPaneContainer::AddSubPaneContainer

BOOL AddSubPaneContainer(
    CPaneContainer* pContainer,
    BOOL bRightNodeNew);

Parâmetros

[in] pContainer
[in] bRightNodeNew

Valor de retorno

Comentários

CPaneContainer::CalcAvailablePaneSpace

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

Parâmetros

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

Valor de retorno

Comentários

CPaneContainer::CalcAvailableSpace

virtual CSize CalcAvailableSpace(
    CSize sizeStretch,
    BOOL bLeftBar);

Parâmetros

[in] sizeStretch
[in] bLeftBar

Valor de retorno

Comentários

CPaneContainer::CalculateRecentSize

void CalculateRecentSize();

Comentários

CPaneContainer::CheckPaneDividerVisibility

void CheckPaneDividerVisibility();

Comentários

CPaneContainer::Copy

virtual CPaneContainer* Copy(CPaneContainer* pParentContainer);

Parâmetros

[in] pParentContainer

Valor de retorno

Comentários

CPaneContainer::CPaneContainer

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

Parâmetros

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

Comentários

CPaneContainer::DeletePane

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

Parâmetros

[in] pBar
[in] barType

Comentários

CPaneContainer::FindSubPaneContainer

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

Parâmetros

[in] pObject
[in] findCriteria

Valor de retorno

Comentários

CPaneContainer::FindTabbedPane

CDockablePane* FindTabbedPane(UINT nID);

Parâmetros

[in] nID

Valor de retorno

Comentários

CPaneContainer::GetAssociatedSiblingPaneIDs

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

Parâmetros

[in] pBar

Valor de retorno

Comentários

CPaneContainer::GetLeftPane

const CDockablePane* GetLeftPane() const;

Valor de retorno

Comentários

CPaneContainer::GetLeftPaneContainer

const CPaneContainer* GetLeftPaneContainer() const;

Valor de retorno

Comentários

CPaneContainer::GetMinSize

virtual void GetMinSize(CSize& size) const;

Parâmetros

[in] size

Comentários

CPaneContainer::GetMinSizeLeft

virtual void GetMinSizeLeft(CSize& size) const;

Parâmetros

[in] size

Comentários

CPaneContainer::GetMinSizeRight

virtual void GetMinSizeRight(CSize& size) const;

Parâmetros

[in] size

Comentários

CPaneContainer::GetNodeCount

int GetNodeCount() const;

Valor de retorno

Comentários

CPaneContainer::GetPaneDivider

const CPaneDivider* GetPaneDivider() const;

Valor de retorno

Comentários

CPaneContainer::GetParentPaneContainer

CPaneContainer* GetParentPaneContainer() const;

Valor de retorno

Comentários

CPaneContainer::GetRecentPaneDividerRect

CRect GetRecentPaneDividerRect() const;

Valor de retorno

Comentários

CPaneContainer::GetRecentPaneDividerStyle

DWORD GetRecentPaneDividerStyle() const;

Valor de retorno

Comentários

CPaneContainer::GetRecentPercent

int GetRecentPercent();

Valor de retorno

Comentários

CPaneContainer::GetRefCount

LONG GetRefCount();

Valor de retorno

Comentários

CPaneContainer::GetResizeStep

virtual int GetResizeStep() const;

Valor de retorno

Comentários

CPaneContainer::GetRightPane

const CDockablePane* GetRightPane() const;

Valor de retorno

Comentários

CPaneContainer::GetRightPaneContainer

const CPaneContainer* GetRightPaneContainer() const;

Valor de retorno

Comentários

CPaneContainer::GetTotalReferenceCount

int GetTotalReferenceCount() const;

Valor de retorno

Comentários

CPaneContainer::GetWindowRect

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

Parâmetros

[in] rect
[in] bIgnoreVisibility

Comentários

CPaneContainer::IsDisposed

BOOL IsDisposed() const;

Valor de retorno

Comentários

CPaneContainer::IsEmpty

BOOL IsEmpty() const;

Valor de retorno

Comentários

CPaneContainer::IsLeftPane

BOOL IsLeftPane(CDockablePane* pBar) const;

Parâmetros

[in] pBar

Valor de retorno

Comentários

CPaneContainer::IsLeftPaneContainer

BOOL IsLeftPaneContainer() const;

Valor de retorno

Comentários

CPaneContainer::IsLeftPartEmpty

BOOL IsLeftPartEmpty(BOOL bCheckVisibility = FALSE) const;

Parâmetros

[in] bCheckVisibility

Valor de retorno

Comentários

CPaneContainer::IsRightPartEmpty

BOOL IsRightPartEmpty(BOOL bCheckVisibility = FALSE) const;

Parâmetros

[in] bCheckVisibility

Valor de retorno

Comentários

CPaneContainer::IsVisible

BOOL IsVisible() const;

Valor de retorno

Comentários

CPaneContainer::Move

virtual void Move(CPoint ptNewLeftTop);

Parâmetros

[in] ptNewLeftTop

Comentários

CPaneContainer::OnDeleteHidePane

void OnDeleteHidePane(
    CDockablePane* pBar,
    BOOL bHide);

Parâmetros

[in] pBar
[in] bHide

Comentários

CPaneContainer::OnMoveInternalPaneDivider

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

Parâmetros

[in] nOffset
[in] hdwp

Valor de retorno

Comentários

CPaneContainer::OnShowPane

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

Parâmetros

[in] pBar
[in] bShow

Comentários

CPaneContainer::Release

DWORD Release();

Valor de retorno

Comentários

CPaneContainer::ReleaseEmptyPaneContainer

void ReleaseEmptyPaneContainer();

Comentários

CPaneContainer::RemoveNonValidPanes

void RemoveNonValidPanes();

Comentários

CPaneContainer::RemovePane

virtual void RemovePane(CDockablePane* pBar);

Parâmetros

[in] pBar

Comentários

CPaneContainer::Resize

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

Parâmetros

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

Comentários

CPaneContainer::ResizePane

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

Parâmetros

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

Comentários

CPaneContainer::ResizePartOfPaneContainer

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

Parâmetros

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

Comentários

CPaneContainer::Serialize

void Serialize(CArchive& ar);

Parâmetros

[in] ar

Comentários

CPaneContainer::SetPane

void SetPane(
    CDockablePane* pBar,
    BOOL bLeft);

Parâmetros

[in] pBar
[in] bLeft

Comentários

CPaneContainer::SetPaneContainer

void SetPaneContainer(
    CPaneContainer* pContainer,
    BOOL bLeft);

Parâmetros

[in] pContainer
[in] bLeft

Comentários

CPaneContainer::SetPaneDivider

void SetPaneDivider(CPaneDivider* pSlider);

Parâmetros

[in] pSlider

Comentários

CPaneContainer::SetParentPaneContainer

void SetParentPaneContainer(CPaneContainer* p);

Parâmetros

[in] p

Comentários

CPaneContainer::SetRecentPercent

void SetRecentPercent(int nRecentPercent);

Parâmetros

[in] nRecentPercent

Comentários

CPaneContainer::SetUpByID

BOOL SetUpByID(
    UINT nID,
    CDockablePane* pBar);

Parâmetros

[in] nID
[in] pBar

Valor de retorno

Comentários

CPaneContainer::StoreRecentDockSiteInfo

virtual void StoreRecentDockSiteInfo(CDockablePane* pBar);

Parâmetros

[in] pBar

Comentários

CPaneContainer::StretchPaneContainer

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

Parâmetros

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

Valor de retorno

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CObject
Classe CPaneContainerManager