Classe CMultiPaneFrameWnd

A classe CMultiPaneFrameWnd estende a Classe CPaneFrameWnd. Pode dar suporte a vários painéis. Em vez de uma só alça inserida em uma barra de controle, CMultiPaneFrameWnd contém um objeto classe CPaneContainerManager que permite que o usuário encaixe uma CMultiPaneFrameWnd em outra e crie dinamicamente várias janelas flutuantes com guias.

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 CMultiPaneFrameWnd : public CPaneFrameWnd

Membros

Métodos públicos

Nome	Descrição
CMultiPaneFrameWnd::AddPane	Adiciona um painel. (Substitui CPaneFrameWnd::AddPane.)
CMultiPaneFrameWnd::AddRecentPane
CMultiPaneFrameWnd::AdjustLayout	Ajusta o layout da janela com minimoldura. (Substitui CPaneFrameWnd::AdjustLayout.)
CMultiPaneFrameWnd::AdjustPaneFrames	(Substitui CPaneFrameWnd::AdjustPaneFrames.)
CMultiPaneFrameWnd::CalcExpectedDockedRect	Calcula o retângulo esperado de uma janela encaixada. (Substitui CPaneFrameWnd::CalcExpectedDockedRect.)
CMultiPaneFrameWnd::CanBeAttached	Determina se o painel atual pode encaixar em outro painel ou janela de quadro. (Substitui CPaneFrameWnd::CanBeAttached.)
CMultiPaneFrameWnd::CanBeDockedToPane	Determina se a janela com minimoldura pode se encaixar em um painel. (Substitui CPaneFrameWnd::CanBeDockedToPane.)
CMultiPaneFrameWnd::CheckGripperVisibility	(Substitui CPaneFrameWnd::CheckGripperVisibility.)
CMultiPaneFrameWnd::CloseMiniFrame	(Substitui CPaneFrameWnd::CloseMiniFrame.)
CMultiPaneFrameWnd::ConvertToTabbedDocument	Converte o painel em um documento com guias. (Substitui CPaneFrameWnd::ConvertToTabbedDocument.)
CMultiPaneFrameWnd::DockFrame
CMultiPaneFrameWnd::DockPane	Encaixa o painel. (Substitui CPaneFrameWnd::DockPane.)
CMultiPaneFrameWnd::DockRecentPaneToMainFrame
CMultiPaneFrameWnd::GetCaptionText	Retorna o texto da legenda. (Substitui CPaneFrameWnd::GetCaptionText.)
CMultiPaneFrameWnd::GetPaneContainerManager	Retorna uma referência ao objeto interno do gerenciador de contêineres.
CMultiPaneFrameWnd::GetFirstVisiblePane	Retorna o primeiro painel visível contido em uma janela com minimoldura. (Substitui CPaneFrameWnd::GetFirstVisiblePane.)
CMultiPaneFrameWnd::GetPane	Retorna um painel contido na janela com minimoldura. (Substitui CPaneFrameWnd::GetPane.)
CMultiPaneFrameWnd::GetPaneCount	Retorna o número de painéis contidos em uma janela com minimoldura. (Substitui CPaneFrameWnd::GetPaneCount.)
CMultiPaneFrameWnd::GetVisiblePaneCount	Retorna o número de painéis visíveis contidos em uma janela com minimoldura. (Substitui CPaneFrameWnd::GetVisiblePaneCount.)
CMultiPaneFrameWnd::InsertPane
CMultiPaneFrameWnd::LoadState	Carrega o estado do painel com base no registro. (Substitui CPaneFrameWnd::LoadState.)
CMultiPaneFrameWnd::OnDockToRecentPos	Encaixa a janela com minimoldura em sua posição mais recente. (Substitui CPaneFrameWnd::OnDockToRecentPos.)
CMultiPaneFrameWnd::OnKillRollUpTimer	Para o temporizador de rollup. (Substitui CPaneFrameWnd::OnKillRollUpTimer.)
CMultiPaneFrameWnd::OnPaneRecalcLayout	Ajusta o layout de um painel dentro de uma janela com minimoldura. (Substitui CPaneFrameWnd::OnPaneRecalcLayout.)
CMultiPaneFrameWnd::OnSetRollUpTimer	Define o temporizador de rollup. (Substitui CPaneFrameWnd::OnSetRollUpTimer.)
CMultiPaneFrameWnd::OnShowPane	Chamado pela estrutura quando um painel na janela com minimoldura está oculto ou é exibido. (Substitui CPaneFrameWnd::OnShowPane.)
CMultiPaneFrameWnd::PaneFromPoint	Retornará um painel se ele contiver um ponto fornecido pelo usuário dentro de uma janela com minimoldura. (Substitui CPaneFrameWnd::PaneFromPoint.)
CMultiPaneFrameWnd::RemoveNonValidPanes	Chamado pela estrutura para remover painéis não válidos. (Substitui CPaneFrameWnd::RemoveNonValidPanes.)
CMultiPaneFrameWnd::RemovePane	Remove um painel da janela com minimoldura. (Substitui CPaneFrameWnd::RemovePane.)
CMultiPaneFrameWnd::ReplacePane	Substitui um painel por outro. (Substitui CPaneFrameWnd::ReplacePane.)
CMultiPaneFrameWnd::SaveState	Salva o estado do painel no registro. (Substitui CPaneFrameWnd::SaveState.)
CMultiPaneFrameWnd::Serialize	(Substitui CPaneFrameWnd::Serialize.)
CMultiPaneFrameWnd::SetDockState	Define o estado de encaixe. (Substitui CPaneFrameWnd::SetDockState.)
CMultiPaneFrameWnd::SetLastFocusedPane
CMultiPaneFrameWnd::SetPreDockState	Define o estado de pré-encaixe. (Substitui CPaneFrameWnd::SetPreDockState.)
CMultiPaneFrameWnd::StoreRecentDockSiteInfo	(Substitui CPaneFrameWnd::StoreRecentDockSiteInfo.)
CMultiPaneFrameWnd::StoreRecentTabRelatedInfo	(Substitui CPaneFrameWnd::StoreRecentTabRelatedInfo.)

Comentários

A maioria dos métodos nessa classe substitui métodos na classe CPaneFrameWnd.

Se um painel usar o estilo AFX_CBRS_AUTO_ROLLUP e o usuário encaixar esse painel em uma janela de quadro de vários painéis, o usuário poderá acumular a janela independentemente das configurações de estilo dos outros painéis encaixados.

A estrutura cria automaticamente um objeto CMultiPaneFrameWnd quando o usuário torna flutuante um painel que usa o estilo CBRS_FLOAT_MULTI.

Para informações sobre como derivar uma classe da classe CPaneFrameWnd e criá-la dinamicamente, confira CPaneFrameWnd.

Exemplo

O exemplo a seguir demonstra como recuperar um ponteiro para um objeto CMultiPaneFrameWnd. Esse snippet de código faz parte do exemplo Definir Tamanho do Painel.

// CDockablePane* pBar
CMultiPaneFrameWnd *pParentMiniFrame =
    DYNAMIC_DOWNCAST(CMultiPaneFrameWnd, pBar->GetParentMiniFrame());

Hierarquia de herança

CObject

CCmdTarget

CWnd

CPaneFrameWnd

CMultiPaneFrameWnd

Requisitos

Cabeçalho: afxMultiPaneFrameWnd.h

CMultiPaneFrameWnd::AddPane

virtual void AddPane(CBasePane* pWnd);

Parâmetros

[in] pWnd

Comentários

CMultiPaneFrameWnd::AddRecentPane

virtual BOOL AddRecentPane(CDockablePane* pBar);

Parâmetros

[in] pBar

Valor de retorno

Comentários

CMultiPaneFrameWnd::AdjustLayout

virtual void AdjustLayout();

Comentários

CMultiPaneFrameWnd::AdjustPaneFrames

virtual void AdjustPaneFrames();

Comentários

CMultiPaneFrameWnd::CalcExpectedDockedRect

virtual void CalcExpectedDockedRect(
    CWnd* pWndToDock,
    CPoint ptMouse,
    CRect& rectResult,
    BOOL& bDrawTab,
    CDockablePane** ppTargetBar);

Parâmetros

[in] pWndToDock
[in] ptMouse
[in] rectResult
[in] bDrawTab
[in] ppTargetBar

Comentários

CMultiPaneFrameWnd::CanBeAttached

virtual BOOL CanBeAttached() const;

Valor de retorno

Comentários

CMultiPaneFrameWnd::CanBeDockedToPane

virtual BOOL CanBeDockedToPane(const CDockablePane* pDockingBar) const;

Parâmetros

[in] pDockingBar

Valor de retorno

Comentários

CMultiPaneFrameWnd::CheckGripperVisibility

virtual void CheckGripperVisibility();

Comentários

CMultiPaneFrameWnd::CloseMiniFrame

virtual void CloseMiniFrame();

Comentários

CMultiPaneFrameWnd::ConvertToTabbedDocument

virtual void ConvertToTabbedDocument();

Comentários

CMultiPaneFrameWnd::DockFrame

virtual BOOL DockFrame(
    CPaneFrameWnd* pDockedFrame,
    AFX_DOCK_METHOD dockMethod);

Parâmetros

[in] pDockedFrame
[in] dockMethod

Valor de retorno

Comentários

CMultiPaneFrameWnd::DockPane

virtual BOOL DockPane(CDockablePane* pDockedBar);

Parâmetros

[in] pDockedBar

Valor de retorno

Comentários

CMultiPaneFrameWnd::DockRecentPaneToMainFrame

virtual void DockRecentPaneToMainFrame(CDockablePane* pBar);

Parâmetros

[in] pBar

Comentários

CMultiPaneFrameWnd::GetCaptionText

virtual CString GetCaptionText();

Valor de retorno

Comentários

CMultiPaneFrameWnd::GetFirstVisiblePane

virtual CWnd* GetFirstVisiblePane() const;

Valor de retorno

Comentários

CMultiPaneFrameWnd::GetPane

virtual CWnd* GetPane() const;

Valor de retorno

Comentários

CMultiPaneFrameWnd::GetPaneContainerManager

Retorna uma referência ao objeto interno do gerenciador de contêineres.

CPaneContainerManager& GetPaneContainerManager();

Valor de retorno

Uma referência ao objeto interno do gerenciador de contêineres.

Comentários

Esse método pode ser usado para acessar o objeto Classe CPaneContainerManager interno.

CMultiPaneFrameWnd::GetPaneCount

virtual int GetPaneCount() const;

Valor de retorno

Comentários

CMultiPaneFrameWnd::GetVisiblePaneCount

virtual int GetVisiblePaneCount() const;

Valor de retorno

Comentários

CMultiPaneFrameWnd::InsertPane

virtual BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter);

Parâmetros

[in] pControlBar
[in] pTarget
[in] bAfter

Valor de retorno

Comentários

CMultiPaneFrameWnd::LoadState

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

Parâmetros

[in] lpszProfileName
[in] uiID

Valor de retorno

Comentários

CMultiPaneFrameWnd::OnDockToRecentPos

virtual void OnDockToRecentPos();

Comentários

CMultiPaneFrameWnd::OnKillRollUpTimer

virtual void OnKillRollUpTimer();

Comentários

CMultiPaneFrameWnd::OnPaneRecalcLayout

virtual void OnPaneRecalcLayout();

Comentários

CMultiPaneFrameWnd::OnSetRollUpTimer

virtual void OnSetRollUpTimer();

Comentários

CMultiPaneFrameWnd::OnShowPane

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

Parâmetros

[in] pBar
[in] bShow

Comentários

CMultiPaneFrameWnd::PaneFromPoint

virtual CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    BOOL bCheckVisibility);

Parâmetros

[in] point
[in] nSensitivity
[in] bCheckVisibility

Valor de retorno

Comentários

CMultiPaneFrameWnd::RemoveNonValidPanes

virtual void RemoveNonValidPanes();

Comentários

CMultiPaneFrameWnd::RemovePane

virtual void RemovePane(
    CBasePane* pBar,
    BOOL bDestroy = FALSE,
    BOOL bNoDelayedDestroy = TRUE);

Parâmetros

[in] pBar
[in] bDestroy
[in] bNoDelayedDestroy

Comentários

CMultiPaneFrameWnd::ReplacePane

virtual void ReplacePane(
    CBasePane* pBarOrg,
    CBasePane* pBarReplaceWith);

Parâmetros

[in] pBarOrg
[in] pBarReplaceWith

Comentários

CMultiPaneFrameWnd::SaveState

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

Parâmetros

[in] lpszProfileName
[in] uiID

Valor de retorno

Comentários

CMultiPaneFrameWnd::Serialize

virtual void Serialize(CArchive& ar);

Parâmetros

[in] ar

Comentários

CMultiPaneFrameWnd::SetDockState

virtual void SetDockState(CDockingManager* pDockManager);

Parâmetros

[in] pDockManager

Comentários

CMultiPaneFrameWnd::SetLastFocusedPane

void SetLastFocusedPane(HWND hwnd);

Parâmetros

[in] hwnd

Comentários

CMultiPaneFrameWnd::SetPreDockState

virtual BOOL SetPreDockState(
    AFX_PREDOCK_STATE preDockState,
    CBasePane* pBarToDock = NULL,
    AFX_DOCK_METHOD dockMethod = DM_MOUSE);

Parâmetros

[in] preDockState
[in] pBarToDock
[in] dockMethod

Valor de retorno

Comentários

CMultiPaneFrameWnd::StoreRecentDockSiteInfo

virtual void StoreRecentDockSiteInfo(CPane* pBar);

Parâmetros

[in] pBar

Comentários

CMultiPaneFrameWnd::StoreRecentTabRelatedInfo

virtual void StoreRecentTabRelatedInfo(
    CDockablePane* pDockingBar,
    CDockablePane* pTabbedBar);

Parâmetros

[in] pDockingBar
[in] pTabbedBar

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CPaneFrameWnd