Classe CPaneFrameWnd

Artigo
08/04/2024

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

Implementa uma janela com minimoldura que contém um painel. O painel preenche a área de cliente da janela.

Sintaxe

class CPaneFrameWnd : public CWnd

Membros

Métodos públicos

Nome	Descrição
CPaneFrameWnd::AddPane	Adiciona um painel.
CPaneFrameWnd::AddRemovePaneFromGlobalList	Adiciona ou remove um painel da lista global.
CPaneFrameWnd::AdjustLayout	Ajusta o layout da janela com minimoldura.
CPaneFrameWnd::AdjustPaneFrames
CPaneFrameWnd::CalcBorderSize	Calcula o tamanho das bordas de uma janela com minimoldura.
CPaneFrameWnd::CalcExpectedDockedRect	Calcula o retângulo esperado de uma janela encaixada.
CPaneFrameWnd::CanBeAttached	Determina se o painel atual pode ser encaixado a outro painel ou janela de quadro.
CPaneFrameWnd::CanBeDockedToPane	Determina se a janela com minimoldura pode ser encaixada a um painel.
CPaneFrameWnd::CheckGripperVisibility
CPaneFrameWnd::ConvertToTabbedDocument	Converte o painel em um documento com guias.
CPaneFrameWnd::Create	Cria a janela com minimoldura e a anexa ao objeto `CPaneFrameWnd`.
CPaneFrameWnd::CreateEx	Cria a janela com minimoldura e a anexa ao objeto `CPaneFrameWnd`.
CPaneFrameWnd::DockPane	Encaixa o painel.
CPaneFrameWnd::FindFloatingPaneByID	Localiza um painel com a ID de controle especificada na lista global de painéis flutuantes.
CPaneFrameWnd::FrameFromPoint	Localiza a janela com minimoldura que contém um ponto fornecido pelo usuário.
CPaneFrameWnd::GetCaptionHeight	Retorna a altura da legenda da janela com minimoldura.
CPaneFrameWnd::GetCaptionRect	Calcula o retângulo delimitador de uma legenda de janela com minimoldura.
CPaneFrameWnd::GetCaptionText	Retorna o texto da legenda.
CPaneFrameWnd::GetDockingManager
CPaneFrameWnd::GetDockingMode	Retorna o modo de encaixe.
CPaneFrameWnd::GetFirstVisiblePane	Retorna o primeiro painel visível contido em uma janela com minimoldura.
CPaneFrameWnd::GetHotPoint
CPaneFrameWnd::GetPane	Retorna um painel contido na janela com minimoldura.
CPaneFrameWnd::GetPaneCount	Retorna o número de painéis contidos em uma janela com minimoldura.
CPaneFrameWnd::GetParent
CPaneFrameWnd::GetPinState
CPaneFrameWnd::GetRecentFloatingRect
CPaneFrameWnd::GetVisiblePaneCount	Retorna o número de painéis visíveis contidos em uma janela com minimoldura.
CPaneFrameWnd::HitTest	Determina qual bloco de uma janela com minimoldura está em um determinado ponto.
CPaneFrameWnd::IsCaptured
CPaneFrameWnd::IsDelayShow
CPaneFrameWnd::IsRollDown	Determina se uma janela com minimoldura deve ser rolada para baixo.
CPaneFrameWnd::IsRollUp	Determina se uma janela com minimoldura deve ser rolada para cima.
CPaneFrameWnd::KillDockingTimer	Interrompe o temporizador de encaixe.
CPaneFrameWnd::LoadState	Carrega o estado do painel com base no registro.
CPaneFrameWnd::OnBeforeDock	Determina se o encaixe é possível.
CPaneFrameWnd::OnDockToRecentPos	Encaixa a janela com minimoldura em sua posição mais recente.
CPaneFrameWnd::OnKillRollUpTimer	Para o temporizador de rollup.
CPaneFrameWnd::OnMovePane	Move a janela com minimoldura segundo um deslocamento especificado.
CPaneFrameWnd::OnPaneRecalcLayout	Ajusta o layout de um painel autônomo.
CPaneFrameWnd::OnSetRollUpTimer	Define o temporizador de rollup.
CPaneFrameWnd::OnShowPane	Chamado pela estrutura quando um painel na janela com minimoldura está oculto ou é exibido.
CPaneFrameWnd::PaneFromPoint	Retornará um painel se ele contiver um ponto fornecido pelo usuário dentro de uma janela com minimoldura.
CPaneFrameWnd::Pin
`CPaneFrameWnd::PreTranslateMessage`	Usado pela classe CWinApp para converter mensagens de janela antes que elas sejam expedidas para as funções TranslateMessage e DispatchMessage do Windows.
CPaneFrameWnd::RedrawAll	Desenha novamente todas as janelas com minimoldura.
CPaneFrameWnd::RemoveNonValidPanes	Chamado pela estrutura para remover painéis não válidos.
CPaneFrameWnd::RemovePane	Remove um painel da janela com minimoldura.
CPaneFrameWnd::ReplacePane	Substitui um painel por outro.
CPaneFrameWnd::SaveState	Salva o estado do painel no registro.
`CPaneFrameWnd::Serialize`	Lê ou grava esse objeto de ou em uma camada de arquivos.
CPaneFrameWnd::SetCaptionButtons	Define os botões de título.
CPaneFrameWnd::SetDelayShow
CPaneFrameWnd::SetDockingManager
CPaneFrameWnd::SetDockingTimer	Define o temporizador de encaixe.
CPaneFrameWnd::SetDockState	Define o estado de encaixe.
CPaneFrameWnd::SetHotPoint
CPaneFrameWnd::SetPreDockState	Chamado pela estrutura para definir o estado pré-encaixe.
CPaneFrameWnd::SizeToContent	Ajusta o tamanho de uma janela com minimoldura para que ela seja equivalente em tamanho a um painel autônomo.
CPaneFrameWnd::StartTearOff	Remove um menu.
CPaneFrameWnd::StoreRecentDockSiteInfo
CPaneFrameWnd::StoreRecentTabRelatedInfo

Métodos protegidos

Nome	Descrição
CPaneFrameWnd::OnCheckRollState	Determina se uma janela com minimoldura deve ser rolada para cima ou para baixo.
CPaneFrameWnd::OnDrawBorder	Desenha as bordas de uma janela com minimoldura.

Membros de dados

Nome	Descrição
CPaneFrameWnd::m_bUseSaveBits	Especifica se a classe de janela deve ser registrada com o estilo de classe CS_SAVEBITS.

Comentários

A estrutura cria automaticamente um objeto CPaneFrameWnd quando um painel é alternado do estado encaixado para o estado flutuante.

Uma janela com minimoldura pode ser arrastada com o conteúdo visível (encaixe imediato) ou usando um retângulo de arraste (encaixe padrão). O modo de encaixe do painel de contêiner da janela com minimoldura determina o comportamento de arraste dela. Para obter mais informações, consulte CBasePane::GetDockingMode.

Uma janela com minimoldura exibe botões na legenda de acordo com o estilo do painel autônomo. Se o painel puder ser fechado (CBasePane::CanBeClosed), ele exibirá um botão Fechar. Se o painel tiver o estilo AFX_CBRS_AUTO_ROLLUP, ele exibirá um pino.

Se você derivar uma classe de CPaneFrameWnd, deverá informar à estrutura como criá-la. Crie a classe substituindo CPane::CreateDefaultMiniframe ou defina o membro CPane::m_pMiniFrameRTC para que ele aponte para as informações da classe de runtime de sua classe.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CPaneFrameWnd

Requisitos

Cabeçalho: afxPaneFrameWnd.h

CPaneFrameWnd::AddPane

Adiciona um painel.

virtual void AddPane(CBasePane* pWnd);

Parâmetros

pWnd
[in] O painel a ser adicionado.

CPaneFrameWnd::AddRemovePaneFromGlobalList

Adiciona ou remove um painel da lista global.

static BOOL __stdcall AddRemovePaneFromGlobalList(
    CBasePane* pWnd,
    BOOL bAdd);

Parâmetros

pWnd
[in] O painel a ser adicionado ou removido.

bAdd
[in] Se for diferente de zero, adicionar o painel. Se for 0, remover o painel.

Valor de retorno

Diferente de zero se o método foi bem-sucedido; caso contrário, 0.

CPaneFrameWnd::AdjustLayout

Ajusta o layout da janela com minimoldura.

virtual void AdjustLayout();

CPaneFrameWnd::AdjustPaneFrames

virtual void AdjustPaneFrames();

Comentários

CPaneFrameWnd::CalcBorderSize

Calcula o tamanho das bordas de uma janela com minimoldura.

virtual void CalcBorderSize(CRect& rectBorderSize) const;

Parâmetros

rectBorderSize
[out] Contém o tamanho, em pixels, da borda da janela com minimoldura.

Comentários

Esse método é chamado pela estrutura para calcular o tamanho da borda de uma janela com minimoldura. O tamanho retornado depende de a janela com minimoldura conter uma barra de ferramentas ou um CDockablePane.

CPaneFrameWnd::CalcExpectedDockedRect

Calcula o retângulo esperado de uma janela encaixada.

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

Parâmetros

pWndToDock
[in] Um ponteiro para a janela a ser encaixada.

ptMouse
[in] O local do mouse.

rectResult
[out] O retângulo calculado.

bDrawTab
[out] Se TRUE, desenhar uma guia. Se FALSE, não desenhar uma guia.

ppTargetBar
[out] Um ponteiro para o painel de destino.

Comentários

Esse método calcula o retângulo que uma janela ocuparia se um usuário arrastasse a janela para o ponto especificado pelo ptMouse e a encaixasse lá.

CPaneFrameWnd::CanBeAttached

Determina se o painel atual pode ser encaixado a outro painel ou janela de quadro.

virtual BOOL CanBeAttached() const;

Valor de retorno

TRUE se o painel puder ser encaixado em outro painel ou janela de quadro; caso contrário, FALSE.

CPaneFrameWnd::CanBeDockedToPane

Determina se a janela com minimoldura pode ser encaixada a um painel.

virtual BOOL CanBeDockedToPane(const CDockablePane* pDockingBar) const;

Parâmetros

pDockingBar
[in] Um painel.

Valor de retorno

Diferente de zero se a janela com minimoldura puder ser encaixada em pDockingBar; caso contrário, 0.

CPaneFrameWnd::CheckGripperVisibility

virtual void CheckGripperVisibility();

Comentários

CPaneFrameWnd::ConvertToTabbedDocument

Converte o painel em um documento com guias.

virtual void ConvertToTabbedDocument();

CPaneFrameWnd::Create

Cria uma janela com minimoldura e a anexa ao objeto CPaneFrameWnd.

virtual BOOL Create(
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    CCreateContext* pContext = NULL);

Parâmetros

lpszWindowName
[in] Especifica o texto a ser exibido na janela com minimoldura.

dwStyle
[in] Especifica o estilo da janela. Para obter mais informações, consulte Estilos de Janela.

rect
[in] Especifica o tamanho e a posição iniciais da janela.

pParentWnd
[in, out] Especifica o quadro pai da janela com minimoldura. Esse valor não deve ser NULL.

pContext
[in, out] Especifica o contexto definido pelo usuário.

Valor de retorno

TRUE se a janela foi criada com êxito; caso contrário, FALSE.

Comentários

Uma janela com minimoldura é criada em duas etapas. Primeiro, a estrutura cria um objeto CPaneFrameWnd. Depois, ela chama Create para criar a janela com minimoldura do Windows e anexá-la ao objeto CPaneFrameWnd.

CPaneFrameWnd::CreateEx

Cria uma janela com minimoldura e a anexa ao objeto CPaneFrameWnd.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    CCreateContext* pContext=NULL);

Parâmetros

dwStyleEx
[in] Especifica o estilo da janela estendida. Para obter mais informações, consulte Estilos de janelas estendidas

lpszWindowName
[in] Especifica o texto a ser exibido na janela com minimoldura.

dwStyle
[in] Especifica o estilo da janela. Para obter mais informações, consulte Estilos de Janela.

rect
[in] Especifica o tamanho e a posição iniciais da janela.

pParentWnd
[in, out] Especifica o quadro pai da janela com minimoldura. Esse valor não deve ser NULL.

pContext
[in, out] Especifica o contexto definido pelo usuário.

Valor de retorno

TRUE se a janela foi criada com êxito; caso contrário, FALSE.

Comentários

CPaneFrameWnd::DockPane

Encaixa o painel.

virtual CDockablePane* DockPane(BOOL& bWasDocked);

Parâmetros

bWasDocked
[out] TRUE se o painel já foi encaixado; caso contrário, FALSE.

Valor de retorno

Se a operação tiver sido bem-sucedida, o CDockablePane ao qual o painel foi encaixado; caso contrário, NULL.

CPaneFrameWnd::FindFloatingPaneByID

Localiza um painel com a ID de controle especificada na lista global de painéis flutuantes.

static CBasePane* FindFloatingPaneByID(UINT nID);

Parâmetros

Nid
[in] Representa a ID de controle do painel a ser encontrado.

Valor de retorno

O painel com a ID de controle especificada; caso contrário, NULL se nenhum painel tiver a ID de controle especificada.

CPaneFrameWnd::FrameFromPoint

Localiza a janela com minimoldura que contém o ponto especificado.

static CPaneFrameWnd* __stdcall FrameFromPoint(
    CPoint pt,
    int nSensitivity,
    CPaneFrameWnd* pFrameToExclude = NULL,
    BOOL bFloatMultiOnly = FALSE);

Parâmetros

pt
[in] O ponto, em coordenadas da tela.

nSensitivity
[in] Aumenta a área de pesquisa da janela com minimoldura segundo esse tamanho. Uma janela com minimoldura atende aos critérios de pesquisa se o ponto determinado está na área aumentada.

pFrameToExclude
[in] Especifica uma janela com minimoldura a ser excluída da pesquisa.

bFloatMultiOnly
[in] Se TRUE, pesquisar apenas janelas com minimoldura que têm o estilo CBRS_FLOAT_MULTI. Se FALSE, pesquisar todas as janelas com minimoldura.

Valor de retorno

Um ponteiro para a janela com minimoldura que contém pt; caso contrário, NULL.

CPaneFrameWnd::GetCaptionHeight

Retorna a altura da legenda da janela com minimoldura.

virtual int GetCaptionHeight() const;

Valor de retorno

A altura, em pixels, da janela com minimoldura.

Comentários

Chame esse método para determinar a altura de uma janela com minimoldura. Por padrão, a altura é definida como SM_CYSMCAPTION. Para saber mais, confira Função GetSystemMetrics.

CPaneFrameWnd::GetCaptionRect

Calcula o retângulo delimitador de uma legenda de janela com minimoldura.

virtual void GetCaptionRect(CRect& rectCaption) const;

Parâmetros

rectCaption
[out] Contém o tamanho e a posição da legenda da janela com minimoldura, em coordenadas de tela.

Comentários

Esse método é chamado pela estrutura para calcular o retângulo delimitador de uma legenda da janela com minimoldura.

CPaneFrameWnd::GetCaptionText

Retorna o texto da legenda.

virtual CString GetCaptionText();

Valor de retorno

O texto de legenda da janela com minimoldura.

Comentários

Esse método é chamado pela estrutura quando exibe o texto de legenda.

CPaneFrameWnd::GetDockingManager

CDockingManager* GetDockingManager() const;

Valor de retorno

Comentários

CPaneFrameWnd::GetDockingMode

Retorna o modo de encaixe.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Valor de retorno

Define o modo de encaixe. Um dos seguintes valores:

DT_STANDARD
DT_IMMEDIATE
DT_SMART

CPaneFrameWnd::GetFirstVisiblePane

Retorna o primeiro painel visível contido em uma janela com minimoldura.

virtual CWnd* GetFirstVisiblePane() const;

Valor de retorno

O primeiro painel na janela com minimoldura ou NULL se ela não contiver painéis.

CPaneFrameWnd::GetHotPoint

CPoint GetHotPoint() const;

Valor de retorno

Comentários

CPaneFrameWnd::GetPane

Retorna um painel contido na janela com minimoldura.

virtual CWnd* GetPane() const;

Valor de retorno

O painel contido na janela com minimoldura ou NULL se ela não contiver painéis.

Comentários

CPaneFrameWnd::GetPaneCount

Retorna o número de painéis contidos em uma janela com minimoldura.

virtual int GetPaneCount() const;

Valor de retorno

O número de painéis na janela com minimoldura. Esse valor pode ser zero.

Comentários

CPaneFrameWnd::GetParent

CWnd* GetParent();

Valor de retorno

Comentários

CPaneFrameWnd::GetPinState

BOOL GetPinState() const;

Valor de retorno

Comentários

CPaneFrameWnd::GetRecentFloatingRect

CRect GetRecentFloatingRect() const;

Valor de retorno

Comentários

CPaneFrameWnd::GetVisiblePaneCount

Retorna o número de painéis visíveis contidos em uma janela com minimoldura.

virtual int GetVisiblePaneCount() const;

Valor de retorno

O número de painéis visíveis.

Comentários

CPaneFrameWnd::HitTest

Determina qual bloco de uma janela com minimoldura está em um determinado ponto.

virtual LRESULT HitTest(
    CPoint point,
    BOOL bDetectCaption);

Parâmetros

point
[in] O ponto a ser testado.

bDetectCaption
[in] Se TRUE, verificar o ponto em relação à legenda. Se FALSE, ignorar a legenda.

Valor de retorno

Um dos seguintes valores:

Valor	Significado
HTNOWHERE	O ponto está fora da janela com minimoldura.
HTCLIENT	O ponto está na área de cliente.
HTCAPTION	O ponto está na legenda.
HTTOP	O ponto está na parte superior.
HTTOPLEFT	O ponto está na parte superior esquerda.
HTTOPRIGHT	O ponto está na parte superior direita.
HTLEFT	O ponto está no lado esquerdo.
HTRIGHT	O ponto está no lado direito.
HTBOTTOM	O ponto está na parte inferior.
HTBOTTOMLEFT	O ponto está na parte inferior esquerda.
HTBOTTOMRIGHT	O ponto está na parte inferior direita.

CPaneFrameWnd::IsCaptured

BOOL IsCaptured() const;

Valor de retorno

Comentários

CPaneFrameWnd::IsDelayShow

BOOL IsDelayShow() const;

Valor de retorno

Comentários

CPaneFrameWnd::IsRollDown

Determina se uma janela com minimoldura deve ser rolada para baixo.

virtual BOOL IsRollDown() const;

Valor de retorno

TRUE se a janela com minimoldura precisar ser rolada para baixo; caso contrário, FALSE.

Comentários

Esse método é chamado pela estrutura para determinar se uma janela com minimoldura deve ser rolada para baixo. O recurso de rolar para cima/para baixo será habilitado para uma janela com minimoldura se ela contiver pelo menos um painel que tenha o sinalizador AFX_CBRS_AUTO_ROLLUP. O sinalizador é definido quando um painel é criado. Para saber mais, confira CBasePane::CreateEx.

Por padrão, a estrutura verifica se o ponteiro do mouse está dentro do retângulo delimitador da janela com minimoldura para determinar se a janela deve ser rolada para baixo. Você pode substituir esse comportamento em uma classe derivada.

CPaneFrameWnd::IsRollUp

Determina se uma janela com minimoldura deve ser rolada para cima.

virtual BOOL IsRollUp() const;

Valor de retorno

TRUE se a janela com minimoldura precisar ser rolada para cima; caso contrário, FALSE.

Comentários

Esse método é chamado pela estrutura para determinar se uma janela com minimoldura deve ser rolada para cima. O recurso de rolar para cima/para baixo será habilitado para uma janela com minimoldura se ela contiver pelo menos um painel que tenha o sinalizador AFX_CBRS_AUTO_ROLLUP. O sinalizador é definido quando um painel é criado. Para saber mais, confira CBasePane::CreateEx.

Por padrão, a estrutura verifica se o ponteiro do mouse está dentro do retângulo delimitador da janela com minimoldura para determinar se a janela deve ser rolada para cima. Você pode substituir esse comportamento em uma classe derivada.

CPaneFrameWnd::KillDockingTimer

Interrompe o temporizador de encaixe.

void KillDockingTimer();

CPaneFrameWnd::LoadState

Carrega o estado do painel com base no registro.

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

Parâmetros

lpszProfileName
[in] O nome do perfil.

uiID
[in] A ID do painel.

Valor de retorno

TRUE se o estado do painel tiver sido carregado com êxito; caso contrário, FALSE.

CPaneFrameWnd::m_bUseSaveBits

Especifica se a classe da janela que tem o estilo de classe CS_SAVEBITS deve ser registrada.

AFX_IMPORT_DATA static BOOL m_bUseSaveBits;

Comentários

Defina esse membro estático como TRUE para registrar a classe da janela com minimoldura que tem o estilo CS_SAVEBITS. Isso pode ajudar a reduzir a cintilação quando um usuário arrasta a janela com minimoldura.

CPaneFrameWnd::OnBeforeDock

Determina se o encaixe é possível.

virtual BOOL OnBeforeDock();

Valor de retorno

TRUE se o encaixe for possível; caso contrário, FALSE.

CPaneFrameWnd::OnCheckRollState

Determina se uma janela com minimoldura deve ser rolada para cima ou para baixo.

virtual void OnCheckRollState();

Comentários

Esse método é chamado pela estrutura para determinar se uma janela com minimoldura deve ser rolada para cima ou para baixo.

Por padrão, a estrutura chama CPaneFrameWnd::IsRollUp e CPaneFrameWnd::IsRollDown e apenas alonga ou restaura a janela com minimoldura. Você pode substituir esse método em uma classe derivada para usar um efeito visual diferente.

CPaneFrameWnd::OnDockToRecentPos

Encaixa a janela com minimoldura em sua posição mais recente.

virtual void OnDockToRecentPos();

CPaneFrameWnd::OnDrawBorder

Desenha as bordas de uma janela com minimoldura.

virtual void OnDrawBorder(CDC* pDC);

Parâmetros

pDC
[in] O contexto do dispositivo usado para desenhar a borda.

Comentários

Esse método é chamado pela estrutura para desenhar as bordas da janela com minimoldura.

CPaneFrameWnd::OnKillRollUpTimer

Para o temporizador de rollup.

virtual void OnKillRollUpTimer();

CPaneFrameWnd::OnMovePane

Move a janela com minimoldura segundo um deslocamento especificado.

virtual void OnMovePane(
    CPane* pBar,
    CPoint ptOffset);

Parâmetros

pBar
[in] Um ponteiro para um painel (ignorado).

ptOffset
[in] O deslocamento segundo o qual mover o painel.

CPaneFrameWnd::OnPaneRecalcLayout

Ajusta o layout de um painel dentro de uma janela com minimoldura.

virtual void OnPaneRecalcLayout();

Comentários

A estrutura chama esse método quando precisa ajustar o layout de um painel dentro da janela com minimoldura.

Por padrão, o painel é posicionado de modo a cobrir a área de cliente completa da janela com minimoldura.

CPaneFrameWnd::OnSetRollUpTimer

Define o temporizador de rollup.

virtual void OnSetRollUpTimer();

CPaneFrameWnd::OnShowPane

Chamado pela estrutura quando um painel na janela com minimoldura está oculto ou é exibido.

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

Parâmetros

pBar
[in] O painel que está sendo mostrado ou ocultado.

bShow
[in] TRUE se o painel estiver sendo mostrado; FALSE se estiver sendo ocultado.

Comentários

Chamado pela estrutura quando um painel na janela com minimoldura é mostrado ou ocultado. A implementação padrão não tem ação.

CPaneFrameWnd::Pin

void Pin(BOOL bPin = TRUE);

Parâmetros

[in] bPin

Comentários

CPaneFrameWnd::PaneFromPoint

Retornará um painel se ele contiver um ponto fornecido pelo usuário dentro de uma janela com minimoldura.

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

Parâmetros

point
[in] O ponto em que o usuário clicou, em coordenadas de tela.

nSensitivity
[in] Esse parâmetro não é usado.

bCheckVisibility
[in] TRUE para especificar que somente painéis visíveis devem ser retornados; caso contrário, FALSE.

Valor de retorno

O painel em que o usuário clicou ou NULL se não existir nenhum painel nesse local.

Comentários

Chame esse método para obter um painel que contém o ponto determinado.

CPaneFrameWnd::RedrawAll

Desenha novamente todas as janelas com minimoldura.

static void RedrawAll();

Comentários

Esse método atualiza todas as janelas com minimoldura chamando CWnd::RedrawWindow para cada janela.

CPaneFrameWnd::RemoveNonValidPanes

Chamado pela estrutura para remover painéis não válidos.

virtual void RemoveNonValidPanes();

CPaneFrameWnd::RemovePane

Remove um painel da janela com minimoldura.

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

Parâmetros

pWnd
[in] Um ponteiro para o painel a ser removido.

bDestroy
[in] Especifica o que acontece com a janela com minimoldura. Se bDestroy for TRUE, esse método destruirá a janela com minimoldura imediatamente. Se for FALSE, o método destruirá a janela com minimoldura após um determinado atraso.

bNoDelayedDestroy
[in] Se TRUE, a destruição atrasada será desabilitada. Se FALSE, a destruição atrasada será habilitada.

Comentários

A estrutura pode destruir janelas com minimoldura imediatamente ou após um determinado atraso. Se você quiser atrasar a destruição das janelas com minimoldura, passe FALSE no parâmetro bNoDelayedDestroy. A destruição atrasada ocorre quando a estrutura processa a mensagem de AFX_WM_CHECKEMPTYMINIFRAME.

CPaneFrameWnd::ReplacePane

Substitui um painel por outro.

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

Parâmetros

pBarOrg
[in] Um ponteiro para o painel original.

pBarReplaceWith
[in] Um ponteiro para o painel que substitui o painel original.

CPaneFrameWnd::SaveState

Salva o estado do painel no registro.

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

Parâmetros

lpszProfileName
[in] O nome do perfil.

uiID
[in] A ID do painel.

Valor de retorno

TRUE se o estado do painel foi salvo com êxito; caso contrário, FALSE.

CPaneFrameWnd::SetCaptionButtons

Define os botões de título.

virtual void SetCaptionButtons(DWORD dwButtons);

Parâmetros

dwButtons
[in] Uma combinação OR bit a bit dos seguintes valores:

AFX_CAPTION_BTN_CLOSE
AFX_CAPTION_BTN_PIN
AFX_CAPTION_BTN_MENU
AFX_CAPTION_BTN_CUSTOMIZE

CPaneFrameWnd::SetDelayShow

void SetDelayShow(BOOL bDelayShow);

Parâmetros

[in] bDelayShow

Comentários

CPaneFrameWnd::SetDockingManager

void SetDockingManager(CDockingManager* pManager);

Parâmetros

[in] pManager

Comentários

CPaneFrameWnd::SetDockingTimer

Define o temporizador de encaixe.

void SetDockingTimer(UINT nTimeOut);

Parâmetros

nTimeOut
[in] Valor do tempo limite, em milissegundos.

CPaneFrameWnd::SetDockState

Define o estado de encaixe.

virtual void SetDockState(CDockingManager* pDockManager);

Parâmetros

pDockManager
[in] Um ponteiro para um gerente de encaixe.

CPaneFrameWnd::SetHotPoint

void SetHotPoint(CPoint& ptNew);

Parâmetros

[in] ptNew

Comentários

CPaneFrameWnd::SetPreDockState

Chamado pela estrutura para definir o estado pré-encaixe.

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

Parâmetros

preDockState
[in] Valores possíveis:

PDS_NOTHING,
PDS_DOCK_REGULAR,
PDS_DOCK_TO_TAB

pBarToDock
[in] Um ponteiro para o painel a ser encaixado.

dockMethod
[in] O método de encaixe. (Este parâmetro é ignorado.)

Valor de retorno

TRUE se a janela com minimoldura estiver desencaixada; FALSE se estiver encaixada.

CPaneFrameWnd::SizeToContent

Ajusta o tamanho de uma janela com minimoldura para que ela seja equivalente a um painel autônomo.

virtual void SizeToContent();

Comentários

Chame esse método para ajustar o tamanho de uma janela com minimoldura para o tamanho de um painel autônomo.

CPaneFrameWnd::StartTearOff

Remove um menu.

BOOL StartTearOff(CMFCPopu* pMenu);

Parâmetros

pMenu
[in] Um ponteiro para um menu.

Valor de retorno

TRUE se o método foi bem-sucedido, do contrário, será FALSE.

CPaneFrameWnd::StoreRecentDockSiteInfo

virtual void StoreRecentDockSiteInfo(CPane* pBar);

Parâmetros

[in] pBar

Comentários

CPaneFrameWnd::StoreRecentTabRelatedInfo

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

Partilhar via

Classe CPaneFrameWnd

Sintaxe

Membros

Métodos públicos

Métodos protegidos

Membros de dados

Comentários

Hierarquia de herança

Requisitos

CPaneFrameWnd::AddPane

Parâmetros

CPaneFrameWnd::AddRemovePaneFromGlobalList

Parâmetros

Valor de retorno

CPaneFrameWnd::AdjustLayout

CPaneFrameWnd::AdjustPaneFrames

Comentários

CPaneFrameWnd::CalcBorderSize

Parâmetros

Comentários

CPaneFrameWnd::CalcExpectedDockedRect

Parâmetros

Comentários

CPaneFrameWnd::CanBeAttached

Valor de retorno

CPaneFrameWnd::CanBeDockedToPane

Parâmetros

Valor de retorno

CPaneFrameWnd::CheckGripperVisibility

Comentários

CPaneFrameWnd::ConvertToTabbedDocument

CPaneFrameWnd::Create

Parâmetros

Valor de retorno

Comentários

CPaneFrameWnd::CreateEx

Parâmetros

Valor de retorno

Comentários

CPaneFrameWnd::DockPane

Parâmetros

Valor de retorno

CPaneFrameWnd::FindFloatingPaneByID

Parâmetros

Valor de retorno

CPaneFrameWnd::FrameFromPoint

Parâmetros

Valor de retorno

CPaneFrameWnd::GetCaptionHeight

Valor de retorno

Comentários

CPaneFrameWnd::GetCaptionRect

Parâmetros

Comentários

CPaneFrameWnd::GetCaptionText

Valor de retorno

Comentários

CPaneFrameWnd::GetDockingManager

Valor de retorno

Comentários

CPaneFrameWnd::GetDockingMode

Valor de retorno

CPaneFrameWnd::GetFirstVisiblePane

Valor de retorno

CPaneFrameWnd::GetHotPoint

Valor de retorno

Comentários

CPaneFrameWnd::GetPane

Valor de retorno

Comentários

CPaneFrameWnd::GetPaneCount

Valor de retorno

Comentários

CPaneFrameWnd::GetParent

Valor de retorno

Comentários

CPaneFrameWnd::GetPinState

Valor de retorno

Comentários