Classe CDockablePane

Artigo
06/10/2015

Implementa um painel qualquer pessoa que possa ser inserido em um site da plataforma ou ser incluído em um painel com guias.

class CDockablePane : public CPane

Membros

Construtores public

Nome	Descrição
CDockablePane::CDockablePane	As compilações e inicializam um objeto de CDockablePane .

Métodos públicos

Nome	Descrição
CDockablePane::AttachToTabWnd	Anexa um painel para outro painel. Isso cria um painel com guias.
CDockablePane::CalcFixedLayout	Retorna o tamanho do retângulo de painel.
CDockablePane::CanAcceptMiniFrame	Determina se o quadro mini especificado pode ser conectado ao painel.
CDockablePane::CanAcceptPane	Determina se outro painel pode ser conectado no painel atual.
CDockablePane::CanAutoHide	Determina se o painel suporta modo automático ocultar de. Overrides ( CBasePane::CanAutoHide.)
CDockablePane::CanBeAttached	Determina se o painel atual pode ser conectado a um outro painel.
CDockablePane::ConvertToTabbedDocument	Converte um ou vários painéis encaixáveis a MDI catalogou documentos.
CDockablePane::CopyState	Copia o estado de um painel encaixável.
CDockablePane::Create	Cria o controle e anexar-las ao objeto de CDockablePane .
CDockablePane::CreateDefaultPaneDivider	Cria um divisor padrão para o painel enquanto está sendo conectado a uma janela do quadro.
CDockablePane::CreateEx	Cria o controle e anexar-las ao objeto de CDockablePane .
CDockablePane::CreateTabbedPane	Cria um painel com guias do painel atual.
CDockablePane::DockPaneContainer	Insere um contêiner para o painel.
CDockablePane::DockPaneStandard	Insere um painel usando o encaixe de estrutura (padrão).
CDockablePane::DockToFrameWindow	Usado internamente. Para inserir um painel, use CPane::DockPane ou CDockablePane::DockToWindow.
CDockablePane::DockToRecentPos	Insere um painel à sua posição recente armazenada de encaixe.
CDockablePane::DockToWindow	Plug-ins um painel de encaixe para outro painel de encaixe.
CDockablePane::EnableAutohideAll	Habilita ou desabilita o modo de incrementos ocultar esse painel para junto com outros painéis no recipiente.
CDockablePane::EnableGripper	Mostra ou oculta a legenda (alça).
CDockablePane::GetAHRestoredRect	Especifica a posição do painel quando visível no modo automático ocultar de.
CDockablePane::GetAHSlideMode	Recupera o modo automático de esmaecer oculte seções para o painel.
CDockablePane::GetAutoHideButton	Usado internamente.
CDockablePane::GetAutoHideToolBar	Usado internamente.
CDockablePane::GetCaptionHeight	Retorna a altura da barra de título atual.
CDockablePane::GetDefaultPaneDivider	Retorna o divisor padrão do painel para o contêiner do painel.
CDockablePane::GetDockingStatus	Determina a capacidade de um painel de ser encaixada fornecido com base no local do ponteiro.
CDockablePane::GetDragSensitivity	Retorna a sensibilidade de arrasto de um painel de encaixe.
CDockablePane::GetLastPercentInPaneContainer	Recupera a porcentagem de espaço que um painel ocupa dentro de seu recipiente.
CDockablePane::GetTabArea	Recupera a área da guia para o painel.
CDockablePane::GetTabbedPaneRTC	Retorna informações de classe de tempo de execução em uma janela com guias que é criada quando outro painel de entrada para o painel atual.
CDockablePane::HasAutoHideMode	Especifica se um painel de encaixe pode ser alternado para modo automático ocultar de.
CDockablePane::HitTest	Especifica o local específico em um painel onde o usuário clica em um mouse.
CDockablePane::IsAccessibilityCompatible	Usado internamente.
CDockablePane::IsAutohideAllEnabled	Indica se o painel de encaixe e todos outros no recipiente painéis podem ser colocados no modo automático ocultar de.
CDockablePane::IsAutoHideMode	Determina se um painel está no modo automático ocultar de.
CDockablePane::IsChangeState	Usado internamente.
CDockablePane::IsDocked	Determina se o painel atual está conectado.
CDockablePane::IsHideInAutoHideMode	Determina o comportamento de um painel que se está em modo de incrementos ocultar mostrado está oculto (ou) chamando ShowPane.
CDockablePane::IsInFloatingMultiPaneFrameWnd	Especifica se o painel em uma janela de quadro chave com multipainéis.
CDockablePane::IsResizable	Especifica se o painel é redimensionável.
CDockablePane::IsTabLocationBottom	Especifica se os guias estão localizados na parte superior ou inferior do painel.
CDockablePane::IsTracked	Especifica se um painel está sendo arrastado pelo usuário.
CDockablePane::IsVisible	Determina se o painel atual é visível.
CDockablePane::LoadState	Usado internamente.
CDockablePane::OnAfterChangeParent	Chamado pela estrutura quando o pai de um painel alterar. Overrides ( CPane::OnAfterChangeParent.)
CDockablePane::OnAfterDockFromMiniFrame	Chamado pela estrutura quando uma barra de encaixe flutuante entre em uma janela do quadro.
CDockablePane::OnBeforeChangeParent	Chamado pela estrutura quando o pai do painel é a ponto de alterar. Overrides ( CPane::OnBeforeChangeParent.)
CDockablePane::OnBeforeFloat	Chamado pela estrutura quando um painel é a de ponto flutuante. Overrides ( CPane::OnBeforeFloat.)
CDockablePane::RemoveFromDefaultPaneDividier	A estrutura chama esse método quando um painel está sendo desencaixado.
CDockablePane::ReplacePane	Substitui o painel com um painel especificado.
CDockablePane::RestoreDefaultPaneDivider	A estrutura chama esse método como um painel desserializado para restaurar o divisor padrão do painel.
CDockablePane::SaveState	Usado internamente.
CDockablePane::Serialize	Serializa o painel. Overrides ( CBasePane::Serialize.)
CDockablePane::SetAutoHideMode	/desativar Ativa o painel de encaixe entre o modo visível de incrementos ocultar e.
CDockablePane::SetAutoHideParents	Define o botão e de incrementos ocultar a barra de ferramentas para automático ocultar o painel.
CDockablePane::SetDefaultPaneDivider	Usado internamente.
CDockablePane::SetLastPercentInPaneContainer	Define a porcentagem de espaço que um painel ocupa dentro de seu recipiente.
CDockablePane::SetResizeMode	Usado internamente.
CDockablePane::SetRestoredDefaultPaneDivider	Define o divisor padrão restaurado de painel.
CDockablePane::SetTabbedPaneRTC	Define informações da classe de tempo de execução para uma janela com guias que é criada quando dois painéis digite juntos.
CDockablePane::ShowPane	Mostra ou oculta um painel.
CDockablePane::Slide	Mostra ou oculta um painel com uma animação deslizante que exibe somente quando o painel está no modo automático ocultar de.
CDockablePane::ToggleAutoHide	Modo automático ocultar de encaixar. Overrides ( CPane::ToggleAutoHide .)
CDockablePane::UndockPane	Desencaixa um painel da janela de quadro chave ou de uma janela hospedeira contêiner miniframe.
CDockablePane::UnSetAutoHideMode	Usado internamente. Para definir o modo de incrementos ocultar use, CDockablePane::SetAutoHideMode

Métodos protegidos

Nome	Descrição
CDockablePane::CheckAutoHideCondition	Determina se o painel de encaixe está oculto (no modo de incrementos ocultar.)
CDockablePane::CheckStopSlideCondition	Determina quando um painel de encaixe de incrementos ocultar deslizar deve parar de.
CDockablePane::DrawCaption	Desenha a legenda do painel de encaixe (alça).
CDockablePane::OnPressButtons	Chamado quando o usuário pressiona um botão da barra de título diferente dos botões de AFX_HTCLOSE e de AFX_HTMAXBUTTON .
CDockablePane::OnSlide	Chamado pela estrutura para processar o efeito de esmaecer de incrementos ocultar o painel quando é mostrado ou oculto.

Membros de dados

Nome	Descrição
CDockablePane::m_bDisableAnimation	Especifica se a animação de incrementos ocultar encaixável do painel está desativada.
CDockablePane::m_bHideInAutoHideMode	Determina o comportamento do painel quando o painel está no modo automático ocultar de.
CDockablePane::m_nSlideSteps	Especifica a velocidade de animação do painel quando está sendo exibido ou oculta no modo automático ocultar de.

Comentários

CDockablePane implementa a seguinte funcionalidade:

Ancorando um painel para uma janela de quadro chave.
Alternando um modo de incrementos ocultar o painel do.
Anexando um painel para uma janela com guias.
Flutuantes um painel em uma janela de miniframe.
Inserindo um painel para outro painel que está flutuantes em uma janela de miniframe.
Redimensionando um painel.
Estado de carregar e salvar para um painel de encaixe.

Dica

Informações de estado é salva no Registro do Windows.
Criando um painel com ou sem uma legenda. A legenda pode ter um rótulo de texto e pode ser preenchida com uma cor gradiente.
Arrastando um painel para exibir o conteúdo do painel
Arrastando um painel para exibir um retângulo de arrastar.

Para usar um painel de encaixe em seu aplicativo, derive sua classe do painel de classe de CDockablePane . Inserir o objeto derivado no objeto da janela de quadro chave ou em um objeto da janela que controles a instância do painel. Chame o método de CDockablePane::Create ou o método de CDockablePane::CreateEx quando você processa a mensagem de WM_CREATE na janela do quadro chave. Finalmente, configure o objeto do painel chamando CBasePane::EnableDocking, CBasePane::DockPane, ou CDockablePane::AttachToTabWnd.

Dicas de personalização

As dicas a seguir aplicam a CDockablePane objetos:

Se você chamar CDockablePane::AttachToTabWnd para dois painéis não com guias, encaixáveis, um ponteiro para uma janela com guias será retornado no parâmetro de ppTabbedControlBar . Você pode continuar a adicionar guias a janela com guias usando este parâmetro.
O tipo do painel com guias que é criado por CDockablePane::AttachToTabWnd é determinado pelo objeto de CDockablePane no parâmetro de pTabControlBarAttachTo . Você pode chamar CDockablePane::SetTabbedPaneRTC para definir o tipo do painel com guias que CDockablePane criará. O tipo padrão é determinado por dwTabbedStyle de CDockablePane::Create quando você primeiro cria CDockablePane. Se dwTabbedStyle é AFX_CBRS_OUTLOOK_TABS o tipo padrão é Classe CMFCOutlookBar; se dwTabbedStyle é AFX_CBRS_REGULAR_TABS o tipo padrão é Classe CTabbedPane.
Se você deseja encaixar um painel encaixável para outro, chame o método de CDockablePane::DockToWindow . O painel original deve ser inserido em algum lugar antes de você chamar esse método.
Os controles de CDockablePane::m_bHideInAutoHideMode variáveis de membro como painéis encaixáveis se comportam no modo automático de ocultar quando você chamar CDockablePane::ShowPane. Se esta variável de membro é definido como TRUE, painéis encaixáveis e os botões serão automático oculte seções ocultos. Caso contrário, deslizarão e dentro para fora.
Você pode desativar a animação de incrementos ocultar o definindo variável de membro de CDockablePane::m_bDisableAnimation a TRUE.

Exemplo

O exemplo a seguir demonstra como configurar um objeto de CDockablePane usando vários métodos na classe de CDockablePane . O exemplo ilustra como ativar automática ocultar o qualquer recurso para o painel, encaixável ativar a legenda ou a alça, active o modo de incrementos ocultar mostrar o painel, e animar um painel que se está em modo automático ocultar de. Este trecho de código é parte de Exemplo de demonstração do Visual Studio.

  // GetOwner is an inherited method.
    CDockablePane* pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());


...


        pParentBar->EnableAutohideAll();
        pParentBar->EnableGripper(true);
        pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
        pParentBar->ShowPane(true,false,true);
        pParentBar->Slide(true);