Classe de CBasePane

Artigo
03/26/2013

Classe base para todos os painéis no MFC.

class CBasePane : public CWnd

Membros

Construtores public

Nome	Descrição
CBasePane::CBasePane	Construtor padrão.
CBasePane::~CBasePane	Destruidor.

Métodos públicos

Nome	Descrição
CBasePane::accHitTest	Chamado pela estrutura para recuperar o elemento filho ou o objeto filho em um determinado ponto na tela.Overrides ( CWnd::accHitTest.)
CBasePane::accLocation	Chamado pela estrutura para recuperar o local atual da tela para o objeto especificado.Overrides ( CWnd::accLocation.)
CBasePane::AccNotifyObjectFocusEvent	CBasePane não usa esse método.
CBasePane::accSelect	Chamado pela estrutura para alterar a seleção ou mover o foco do teclado do objeto especificado.Overrides ( CWnd::accSelect.)
CBasePane::AddPane	Adiciona um painel para o gerenciador de encaixe.
CBasePane::AdjustDockingLayout	Redireciona uma chamada para o gerenciador de encaixe para ajustar o layout de encaixe.
CBasePane::AdjustLayout	Chamado pela estrutura quando o painel deve ajustar seu layout interno.
CBasePane::CalcFixedLayout	Calcula o tamanho horizontal de uma barra de controle.
CBasePane::CanAcceptPane	Determina se outro painel puder ser encaixado no painel.
CBasePane::CanAutoHide	Determina se o painel suporta modo automático ocultar de.
CBasePane::CanBeAttached	Determina se o painel pode ser conectado a um outro painel.
CBasePane::CanBeClosed	Determina se o painel puder ser fechado.
CBasePane::CanBeDocked	Determina se o painel pode ser conectado a um outro painel.
CBasePane::CanBeResized	Determina se o painel pode ser redimensionado.
CBasePane::CanBeTabbedDocument	Especifica se o painel puder ser convertido em um documento listado MDI.
CBasePane::CanFloat	Determina se o painel puder flutuante.
CBasePane::CanFocus	Especifica se o painel pode receber o foco.
CBasePane::CopyState	Copia o estado de um determinado painel.
CBasePane::CreateDefaultMiniframe	Se o painel pode posicioná-la tanto, cria uma janela de mini-linguagem quadro.
CBasePane::CreateEx	Cria o painel de controle.
CBasePane::DockPane	Insere um painel para outro painel ou a uma janela do quadro.
CBasePane::DockPaneUsingRTTI	Insere o painel usando informações de tipo em tempo de execução.
CBasePane::DockToFrameWindow	Insere um painel encaixável a um quadro.
CBasePane::DoesAllowDynInsertBefore	Determina se outro painel dinamicamente pode ser inserido entre esse painel e o elemento pai.
CBasePane::EnableDocking	Permite que o encaixe do painel para o quadro chave.
CBasePane::EnableGripper	Habilita ou desabilita a alça.Se a alça é ativado, o usuário pode arrastá-lo para reposicionar o painel.
CBasePane::FillWindowRect	Usado internamente.
CBasePane::FloatPane	Flutua o painel.
CBasePane::get_accChild	Chamado pela estrutura para recuperar o endereço de uma interface de IDispatch para o filho especificado.Overrides ( CWnd::get_accChild.)
CBasePane::get_accChildCount	Chamado pela estrutura para recuperar o número de filhos que pertencem a esse objeto.Overrides ( CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction	Chamado pela estrutura para recuperar uma cadeia de caracteres que descreve a ação padrão para o objeto.Overrides ( CWnd::get_accDefaultAction.)
CBasePane::get_accDescription	Chamado pela estrutura para recuperar uma cadeia de caracteres que descreve a aparência visual do objeto especificado.Overrides ( CWnd::get_accDescription.)
CBasePane::get_accFocus	Chamado pela estrutura para recuperar o objeto que tem o foco do teclado.Overrides ( CWnd::get_accFocus.)
CBasePane::get_accHelp	Chamado pela estrutura para recuperar uma cadeia de caracteres da propriedade da ajuda para o objeto.Overrides ( CWnd::get_accHelp.)
CBasePane::get_accHelpTopic	Chamado pela estrutura para recuperar o caminho completo deWinHelpfile que é associado ao objeto especificado e o identificador do tópico apropriado no arquivo.Overrides ( CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut	Chamado pela estrutura para recuperar a tecla de atalho especificada para o objeto.Overrides ( CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName	Chamado pela estrutura para recuperar o nome do objeto especificado.Overrides ( CWnd::get_accName.)
CBasePane::get_accParent	Chamado pela estrutura para recuperar a interface de IDispatch para o pai do objeto.Overrides ( CWnd::get_accParent.)
CBasePane::get_accRole	Chamado pela estrutura para recuperar informações que descrevem a função do objeto especificado.Overrides ( CWnd::get_accRole.)
CBasePane::get_accSelection	Chamado pela estrutura para recuperar os filhos de este objeto selecionados.Overrides ( CWnd::get_accSelection.)
CBasePane::get_accState	Chamado pela estrutura para recuperar o estado atual do objeto especificado.Overrides ( CWnd::get_accState.)
CBasePane::get_accValue	Chamado pela estrutura para recuperar o valor do objeto especificado.Overrides ( CWnd::get_accValue.)
CBasePane::GetCaptionHeight	Retorna a altura da barra de título.
CBasePane::GetControlBarStyle	Retorna o estilo da barra de controle.
CBasePane::GetCurrentAlignment	Retorna o alinhamento atual do painel.
CBasePane::GetDockingMode	Retorna o modo atual de encaixe para o painel.
CBasePane::GetDockSiteFrameWnd	Retorna um ponteiro para a janela que é o site de encaixe para o painel.
CBasePane::GetEnabledAlignment	Retorna os estilos de CBRS_ALIGN_ que são aplicados para o painel.
CBasePane::GetMFCStyle	Retorna os estilos do painel específicos para MFC.
CBasePane::GetPaneIcon	Retorna um identificador para o ícone do painel.
CBasePane::GetPaneRect	Usado internamente.
CBasePane::GetPaneRow	Retorna um ponteiro para o objeto de CDockingPanesRowonde o painel é conectado.
CBasePane::GetPaneStyle	Retorna o estilo de painel.
CBasePane::GetParentDockSite	Retorna um ponteiro para o site pai da plataforma.
CBasePane::GetParentMiniFrame	Retorna um ponteiro para a janela pai de mini-linguagem quadro.
CBasePane::GetParentTabbedPane	Retorna um ponteiro para o painel pai com guias.
CBasePane::GetParentTabWnd	Retorna um ponteiro para a janela pai que está dentro de um guia.
CBasePane::GetRecentVisibleState	A estrutura chama esse método quando um painel é restaurado de um arquivo neutro.
CBasePane::HideInPrintPreviewMode	Especifica se o painel está oculto no visualizador de impressão.
CBasePane::InsertPane	Registra o painel especificado com o gerenciador de encaixe.
CBasePane::IsAccessibilityCompatible	Especifica se o painel oferece suporte a acessibilidade.
CBasePane::IsAutoHideMode	Determina se um painel está no modo automático ocultar de.
CBasePane::IsDialogControl	Especifica se o painel é um controle de caixa de diálogo.
CBasePane::IsDocked	Determina se o painel está conectado.
CBasePane::IsFloating	Determina se o painel é flutuantes.
CBasePane::IsHorizontal	Determina se o painel estiver conectado horizontalmente.
CBasePane::IsInFloatingMultiPaneFrameWnd	Especifica se o painel em uma janela de quadro chave com multipainéis.
CBasePane::IsMDITabbed	Determina se o painel foi adicionado a uma janela filho MDI como um documento com guias.
CBasePane::IsPaneVisible	Especifica se o sinalizador de WS_VISIBLE é definido para o painel.
CBasePane::IsPointNearDockSite	Determina se um ponto está especificado pelo site da plataforma.
CBasePane::IsResizable	Determina se o painel pode ser redimensionado.
CBasePane::IsRestoredFromRegistry	Determina se o painel é restaurado do Registro.
CBasePane::IsTabbed	Determina se o painel foi inserido no controle de guias de uma janela com guias.
CBasePane::IsTooltipTopmost	Usado internamente.
CBasePane::IsVisible	Determina se o painel é visível.
CBasePane::LoadState	Carrega o estado do painel do Registro.
CBasePane::MoveWindow	Move o painel.
CBasePane::OnAfterChangeParent	Chamado pela estrutura quando o pai do painel é modificado.
CBasePane::OnBeforeChangeParent	Chamado pela estrutura imediatamente antes do painel muda sua janela pai.
CBasePane::OnDrawCaption	A estrutura chama esse método quando a legenda é desenhada.
CBasePane::OnMovePaneDivider	Este método não é usado atualmente.
CBasePane::OnPaneContextMenu	Chamado pela estrutura quando criar um menu que tenha uma lista de painéis.
CBasePane::OnRemoveFromMiniFrame	Chamado pela estrutura quando um painel é removido da sua mini janela pai do quadro.
CBasePane::OnSetAccData	CBasePane não usa esse método.
CBasePane::OnUpdateCmdUI	Usado internamente.
CBasePane::PaneFromPoint	Retorna o painel que contém o ponto especificado.
CBasePane::PreTranslateMessage	Usado pela classe CWinApp transladar mensagens de janela antes que são distribuídos funções do windows de TranslateMessage e de DispatchMessage .Overrides ( CWnd::PreTranslateMessage.)
CBasePane::RecalcLayout	CBasePane não usa esse método.
CBasePane::RemovePaneFromDockManager	Desregistre um painel e remova-o da lista no gerenciador de encaixe.
CBasePane::SaveState	Salvar o estado do painel no Registro.
CBasePane::SelectDefaultFont	Seleciona a fonte padrão para um determinado contexto de dispositivo.
CBasePane::Serialize	Leitura ou grava este objeto ou um arquivo neutro.Overrides ( CObject::Serialize.)
CBasePane::SetControlBarStyle	Defina o estilo da barra de controle.
CBasePane::SetDockingMode	Defina o modo de encaixe para o painel.
CBasePane::SetMDITabbed	Usado internamente.
CBasePane::SetPaneAlignment	Define o alinhamento para o painel.
CBasePane::SetPaneRect	Usado internamente.
CBasePane::SetPaneStyle	Defina o estilo de painel.
CBasePane::SetRestoredFromRegistry	Usado internamente.
CBasePane::SetWindowPos	Altera o tamanho, posição, e a ordem z de um painel.
CBasePane::ShowPane	Mostra ou oculta o painel.
CBasePane::StretchPane	Um painel expande horizontalmente ou verticalmente.
CBasePane::UndockPane	Remove o painel do site da plataforma, padrão de controle deslizante, ou da janela de mini-linguagem quadro onde está conectado no momento.

Métodos protegidos

Nome	Descrição
CBasePane::DoPaint	Preenche o plano de fundo do painel.

Comentários

Se você desejar criar uma classe de painel que suporta os recursos estendidos de encaixe disponíveis no MFC, você deve derivá-lo de CBasePane ou de Classe de CPane.

Dicas de personalização

As dicas a seguir de personalização são pertinentes a Classe de CBasePane e as classes que herdarem de ele:

Quando você cria um painel, você pode aplicar vários novos estilos:
- AFX_CBRS_FLOAT faz o painel flutuante.
- AFX_CBRS_AUTOHIDE ativar o modo automático ocultar de.
- AFX_CBRS_CLOSE permite que o painel seja fechada (oculto).
Esses são os sinalizadores que você pode combinar com um OU bit a bits a operação.

CBasePane implementa os seguintes métodos virtuais booleanas para refletir essas sinalizações: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat.Você pode substituí-los em classes derivadas para personalizar seu comportamento.
Você pode personalizar o comportamento de encaixe substituindo CBasePane::CanAcceptPane.Tem o retorno FALSE do painel de esse método para evitar outro painel de encaixe a ele.
Se você deseja criar um painel estático que não possam flutuante e que evita qualquer outro painel de encaixe antes de ele (semelhante à barra do Outlook no exemplo de OutlookDemo), criar como não flutuante e substituição CBasePane::DoesAllowDynInsertBefore para retornar FALSE.A implementação padrão FALSE retorna se o painel é criado sem o estilo de AFX_CBRS_FLOAT .
Crie todos os painéis com os diferentes identificações de -1.
Para determinar a visibilidade do, use CBasePane::IsVisible.Trata corretamente o estado de visibilidade nos modos com guias de incrementos ocultar e.
Se você deseja criar um painel redimensionável flutuante, criar sem o estilo de AFX_CBRS_FLOAT e chame CFrameWnd::DockControlBar.
Para excluir um painel de um layout de encaixe ou remover uma barra de ferramentas de sua barra da plataforma, chame CBasePane::UndockPane.Não chamar esse método para os painéis no modo de incrementos ocultar para ou painéis que residem nos guias do windows com guias.
Se você deseja flutuante ou desencaixar um painel que se está em modo de incrementos ocultar CDockablePane::SetAutoHideMode , você deve chamar com FALSE como o primeiro argumento antes de chamar CBasePane::FloatPane ou CBasePane::UndockPane.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe de CBasePane .O exemplo demonstra como recuperar um painel de classe de CFrameWndEx e como definir o modo de encaixe, o alinhamento do, e estilo de painel.o código é de Exemplo de preenchimento da palavra.

            // This CMainFrame class extends the CFrameWndEx class.
            // GetPane is a method in the CFrameWndEx class which 
            // Returns a pointer to the pane that has the specified ID.
            CBasePane* pBar = GetPane(ID_VIEW_FORMATBAR);
            if (pBar != NULL)
            {
                // Set the docking mode, the pane alignment, and the pane style.
                pBar->SetDockingMode(DT_STANDARD);
                pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
                pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
                pBar->ShowPane(TRUE, FALSE, FALSE);
            }