Classe CTabbedPane

Artigo
06/10/2015

Implementa a funcionalidade de um painel com guias destacáveis.

class CTabbedPane : public CBaseTabbedPane

Membros

Construtores public

Nome	Descrição
CTabbedPane::CTabbedPane	Construtor padrão.

Métodos públicos

Nome	Descrição
CTabbedPane::DetachPane	Overrides ( CBaseTabbedPane::DetachPane.)
CTabbedPane::EnableTabAutoColor	Habilita ou desabilita coloração automática de guias.
CTabbedPane::FloatTab	Flutua um painel, mas somente se o painel está atualmente em uma guia destacável. Overrides ( CBaseTabbedPane::FloatTab.)
CTabbedPane::GetTabArea	Retorna o tamanho e a posição da área de tabulação dentro da janela com guias.
CTabbedPane::GetTabWnd
CTabbedPane::HasAutoHideMode	Determina se o painel com guias pode ser alternado para modo de autohide. Overrides ( CBaseTabbedPane::HasAutoHideMode.)
CTabbedPane::IsTabLocationBottom	Determina se as guias estão localizados na parte inferior da janela.
CTabbedPane::ResetTabs	Reinicializa todos os painéis com guias ao estado padrão.
CTabbedPane::SetTabAutoColors	Define uma lista de cores personalizados que podem ser usadas quando o recurso automática de cores é ativado.

Membros de dados

Nome	Descrição
CTabbedPane::m_bTabsAlwaysTop	O local padrão para guias no aplicativo.
CTabbedPane::m_pTabWndRTC	Informações da classe de tempo de execução para um personalizado CMFCTabCtrlobjeto derivado de.

Comentários

A estrutura automaticamente cria uma instância da classe quando um usuário anexa um painel para outro apontando para a legenda do segundo painel. Todos os painéis com guias que são criados pela estrutura têm uma identificação de -1.

Para especificar guias normais em vez de guias de Outlook- estilo, passe o estilo de AFX_CBRS_REGULAR_TABS para o método de CDockablePane::CreateEx .

Se você criar um painel com guias com as guias destacáveis, o painel puder ser destruído automaticamente pela estrutura, para que você não deve armazenar o ponteiro. Para obter um ponteiro para o painel com guias, chame o método de CBasePane::GetParentTabbedPane .

Exemplo

Em esse exemplo nós criaremos um objeto de CTabbedPane . Em seguida, usamos CBaseTabbedPane::AddTab para anexar guias adicionais.

CTabbedPane* pTabbededBar = new CTabbedPane (TRUE);
if (!pTabbededBar->Create (_T(""), this, CRect (0, 0, 200, 200),
                           TRUE, 
                           (UINT) -1,
                           WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS |
                           WS_CLIPCHILDREN | CBRS_LEFT |  
                           CBRS_FLOAT_MULTI))
{
    TRACE0("Failed to create Solution Explorer bar\n");
    return FALSE;      // fail to create
}

pTabbededBar->AddTab (&m_wndClassView);
pTabbededBar->AddTab (&m_wndResourceView);
pTabbededBar->AddTab (&m_wndFileView);
pTabbededBar->EnableDocking(CBRS_ALIGN_ANY);
DockPane(pTabbededBar);

Outra maneira de criar um objeto com guias da barra de controle é usar CDockablePane::AttachToTabWnd. O método de AttachToTabWnd dinamicamente cria um objeto com guias do painel usando informações de classe de tempo de execução definida por CDockablePane::SetTabbedPaneRTC.

Em esse exemplo que nós criaremos um painel com guias dinamicamente, anexamos dois guias, e são feitas o segundo guia não destacável.

DockPane(&m_wndClassView);
CTabbedPane* pTabbedBar = NULL;
m_wndResourceView.AttachToTabWnd (&m_wndClassView, DM_SHOW, TRUE,
                                  (CDockablePane**) &pTabbedBar);
m_wndFileView.AttachToTabWnd (pTabbedBar, DM_SHOW, TRUE,
                              (CDockablePane**) &pTabbedBar);
pTabbedBar->GetUnderlyingWindow ()->EnableTabDetach (1, FALSE);