Compartilhar via


Classe CPaneDivider

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

A classe CPaneDivider divide dois painéis, divide dois grupos de painéis ou separa um grupo de painéis da área do cliente da janela do quadro principal.

Sintaxe

class CPaneDivider : public CBasePane

Membros

Construtores públicos

Nome Descrição
CPaneDivider::CPaneDivider

Métodos públicos

Nome Descrição
CPaneDivider::AddPaneContainer
CPaneDivider::AddPane
CPaneDivider::AddRecentPane
CPaneDivider::CalcExpectedDockedRect
CPaneDivider::CalcFixedLayout (Substitui CBasePane::CalcFixedLayout.)
CPaneDivider::CheckVisibility
CPaneDivider::CreateEx (Substitui CBasePane::CreateEx.)
CPaneDivider::DoesAllowDynInsertBefore (Substitui CBasePane::DoesAllowDynInsertBefore.)
CPaneDivider::DoesContainFloatingPane
CPaneDivider::FindPaneContainer
CPaneDivider::FindTabbedPane
CPaneDivider::GetDefaultWidth
CPaneDivider::GetFirstPane
CPaneDivider::GetPaneDividers Retorna a lista de divisores de painel que residem na classe CPaneContainer. Esse método deve ser chamado somente para divisores de painel padrão.
CPaneDivider::GetPaneDividerStyle
CPaneDivider::GetPanes Retorna a lista de painéis que residem na classe CPaneContainer. Esse método deve ser chamado somente para divisores de painel padrão.
CPaneDivider::GetRootContainerRect
CPaneDivider::GetWidth
CPaneDivider::Init
CPaneDivider::InsertPane
CPaneDivider::IsAutoHideMode (Substitui CBasePane::IsAutoHideMode.)
CPaneDivider::IsDefault
CPaneDivider::IsHorizontal (Substitui CBasePane::IsHorizontal.)
CPaneDivider::Move
CPaneDivider::NotifyAboutRelease
CPaneDivider::OnShowPane
CPaneDivider::ReleaseEmptyPaneContainers
CPaneDivider::RemovePane
CPaneDivider::ReplacePane
CPaneDivider::RepositionPanes
CPaneDivider::Serialize (Substitui CBasePane::Serialize.)
CPaneDivider::SetAutoHideMode
CPaneDivider::SetPaneContainerManager
CPaneDivider::ShowWindow
CPaneDivider::StoreRecentDockSiteInfo
CPaneDivider::StoreRecentTabRelatedInfo
Nome Descrição
CPaneDivider::m_nDefaultWidth Especifica a largura padrão em pixels de todos os divisores de painel no aplicativo.
CPaneDivider::m_pSliderRTC Contém um ponteiro para as informações de classe de runtime sobre um objeto derivadoCPaneDivider.

Comentários

A estrutura cria objetosCPaneDivider automaticamente quando um painel é encaixado.

Há dois tipos de divisores de painel:

  • um divisor de painel padrão é criado quando um grupo de painéis é encaixado em um lado da janela de quadro principal. O divisor de painel padrão contém um ponteiro para a Classe CPaneContainerManager e redireciona a maioria das operações no grupo de painéis (como redimensionar um painel ou encaixar outro painel ou contêiner) no gerenciador de contêineres. Cada painel de encaixe mantém um ponteiro para seu divisor de painel padrão.

  • Um divisor de painel regular apenas divide dois painéis em um contêiner. Para obter mais informações, consulte Classe CPaneContainer.

Exemplo

O exemplo a seguir demonstra como obter um objeto CPaneDividerde um objetoCWorkspaceBar. Este snippet de código faz parte da amostra de demonstração de guias MDI.

// CWorkspaceBar m_wndWorkSpace
CPaneDivider *pSlider = m_wndWorkSpace.GetDefaultPaneDivider();

Hierarquia de herança

CObject
CCmdTarget
 └ CWnd
  └ CBasePane
   └ CPaneDivider

Requisitos

Cabeçalho: afxPaneDivider.h

CPaneDivider::SetAutoHideMode

void SetAutoHideMode(BOOL bMode);

Parâmetros

[in] bMode

Comentários

CPaneDivider::SetPaneContainerManager

void SetPaneContainerManager(CPaneContainerManager* p);

Parâmetros

[in] p

Comentários

CPaneDivider::AddPane

virtual void AddPane(CDockablePane* pBar);

Parâmetros

[in] pBar

Comentários

CPaneDivider::AddPaneContainer

virtual BOOL AddPaneContainer(
    CPaneContainerManager& barContainerManager,
    BOOL bOuterEdge);

virtual BOOL AddPaneContainer(
    CDockablePane* pTargetBar,
    CPaneContainerManager& barContainerManager,
    DWORD dwAlignment);

Parâmetros

[in] barContainerManager
[in] bOuterEdge
[in] pTargetBar
[in] dwAlignment

Valor de retorno

Comentários

CPaneDivider::AddRecentPane

virtual CDockablePane* AddRecentPane(CDockablePane* pBar);

Parâmetros

[in] pBar

Valor de retorno

Comentários

CPaneDivider::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

CPaneDivider::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parâmetros

[in] bStretch
[in] bHorz

Valor de retorno

Comentários

CPaneDivider::CheckVisibility

virtual BOOL CheckVisibility();

Valor de retorno

Comentários

CPaneDivider::CPaneDivider

CPaneDivider();

CPaneDivider(
    BOOL bDefaultSlider,
    CWnd* pParent = NULL);

Parâmetros

[in] bDefaultSlider
[in] pParent

Valor de retorno

Comentários

CPaneDivider::CreateEx

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CCreateContext* pContext);

Parâmetros

[in] dwStyleEx
[in] dwStyle
[in] rect
[in] pParentWnd
[in] nID
[in] pContext

Valor de retorno

Comentários

CPaneDivider::DoesAllowDynInsertBefore

virtual BOOL DoesAllowDynInsertBefore() const;

Valor de retorno

Comentários

CPaneDivider::DoesContainFloatingPane

virtual BOOL DoesContainFloatingPane();

Valor de retorno

Comentários

CPaneDivider::FindPaneContainer

CPaneContainer* FindPaneContainer(
    CDockablePane* pBar,
    BOOL& bLeftBar);

Parâmetros

[in] pBar
[in] bLeftBar

Valor de retorno

Comentários

CPaneDivider::FindTabbedPane

CDockablePane* FindTabbedPane(UINT nID);

Parâmetros

[in] nID

Valor de retorno

Comentários

CPaneDivider::GetDefaultWidth

static int __stdcall GetDefaultWidth();

Valor de retorno

Comentários

CPaneDivider::GetFirstPane

const CBasePane* GetFirstPane() const;

Valor de retorno

Comentários

CPaneDivider::GetPaneDividers

Retorna a lista de divisores de painel que residem na classe CPaneContainer. Esse método deve ser chamado somente para divisores de painel padrão.

void GetPaneDividers(CObList& lstSliders);

Parâmetros

lstSliders
[out] Contém a lista de divisores de painel que residem no contêiner do painel.

Comentários

Esse método deve ser chamado somente para divisores de painel padrão. Um divisor de painel padrão é um divisor que redimensiona todo o contêiner do painel.

CPaneDivider::GetPaneDividerStyle

DWORD GetPaneDividerStyle() const;

Valor de retorno

Comentários

CPaneDivider::GetPanes

Retorna a lista de painéis que residem na classe CPaneContainer. Esse método deve ser chamado somente para recuperar os divisores de painel padrão.

void GetPanes(CObList& lstBars);

Parâmetros

lstBars
[out] Contém a lista de painéis que residem no contêiner do painel.

Comentários

Esse método deve ser chamado somente para divisores de painel padrão. Um divisor de painel padrão é um divisor que redimensiona todo o contêiner do painel.

CPaneDivider::GetRootContainerRect

CRect GetRootContainerRect();

Valor de retorno

Comentários

CPaneDivider::GetWidth

int GetWidth() const;

Valor de retorno

Comentários

CPaneDivider::Init

void Init(
    BOOL bDefaultSlider = FALSE,
    CWnd* pParent = NULL);

Parâmetros

[in] bDefaultSlider
[in] pParent

Comentários

CPaneDivider::InsertPane

virtual BOOL InsertPane(
    CDockablePane* pBarToInsert,
    CDockablePane* pTargetBar,
    DWORD dwAlignment,
    LPCRECT lpRect = NULL);

Parâmetros

[in] pBarToInsert
[in] pTargetBar
[in] dwAlignment
[in] lpRect

Valor de retorno

Comentários

CPaneDivider::IsAutoHideMode

BOOL IsAutoHideMode() const;

Valor de retorno

Comentários

CPaneDivider::IsDefault

BOOL IsDefault() const;

Valor de retorno

Comentários

CPaneDivider::IsHorizontal

BOOL IsHorizontal() const;

Valor de retorno

Comentários

CPaneDivider::m_nDefaultWidth

Especifica a largura padrão em pixels de todos os divisores de painel no aplicativo.

AFX_IMPORT_DATA static int m_nDefaultWidth;

CPaneDivider::Move

virtual void Move(
    CPoint& ptOffset,
    BOOL bAdjustLayout = TRUE);

Parâmetros

[in] ptOffset
[in] bAdjustLayout

Comentários

CPaneDivider::m_pSliderRTC

Contém um ponteiro para as informações de classe de runtime sobre um objeto derivado deCPaneDivider.

AFX_IMPORT_DATA static CRuntimeClass* m_pSliderRTC;

Comentários

Defina essa variável de membro se você criar um divisor de painel personalizado. Isso permite que a estrutura crie o divisor de painel quando o painel é desenhado.

Exemplo

O exemplo a seguir mostra como definir a variável de membrom_pSliderRTC:

class CMySplitter : public CPaneDivider
{
...
};

CPaneDivider::m_pSliderRTC = RUNTIME_CLASS(CMySpliter);

CPaneDivider::NotifyAboutRelease

virtual void NotifyAboutRelease();

Comentários

CPaneDivider::OnShowPane

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

Parâmetros

[in] pBar
[in] bShow

Comentários

CPaneDivider::ReleaseEmptyPaneContainers

void ReleaseEmptyPaneContainers();

Comentários

CPaneDivider::RemovePane

virtual void RemovePane(CDockablePane* pBar);

Parâmetros

[in] pBar

Comentários

CPaneDivider::ReplacePane

virtual BOOL ReplacePane(
    CDockablePane* pBarToReplace,
    CDockablePane* pBarToReplaceWith);

Parâmetros

[in] pBarToReplace
[in] pBarToReplaceWith

Valor de retorno

Comentários

CPaneDivider::RepositionPanes

virtual void RepositionPanes(
    CRect& rectNew,
    HDWP& hdwp);

Parâmetros

[in] rectNew
[in] hdwp

Comentários

CPaneDivider::Serialize

void Serialize(CArchive& ar);

Parâmetros

[in] ar

Comentários

CPaneDivider::ShowWindow

void ShowWindow(int nCmdShow);

Parâmetros

[in] nCmdShow

Comentários

CPaneDivider::StoreRecentDockSiteInfo

void StoreRecentDockSiteInfo(CDockablePane* pBar);

Parâmetros

[in] pBar

Comentários

CPaneDivider::StoreRecentTabRelatedInfo

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

Parâmetros

[in] pDockingBar
[in] pTabbedBar

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CPaneContainerManager
Classe CPaneContainer
Classe CDockingManager
Classe CBasePane