Classe CTabbedPane

Artigo
08/25/2010

Implementa a funcionalidade de um painel com guias removíveis.

class CTabbedPane : public CBaseTabbedPane

Membros

Construtores públicos

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

Métodos públicos

Nome	Descrição
CTabbedPane::DetachPane	(Substitui CBaseTabbedPane::DetachPane.)
CTabbedPane::EnableTabAutoColor	Ativa ou desativa a coloração automático das guias.
CTabbedPane::FloatTab	Flutua um painel, mas somente se o painel atualmente residir em uma guia removível.(Substitui CBaseTabbedPane::FloatTab.)
CTabbedPane::GetTabArea	Retorna o dimensionar e posição da área de guias na janela com guias.
CTabbedPane::GetTabWnd
CTabbedPane::HasAutoHideMode	Determina se o painel com guias pode ser alternado para o modo de ocultar automaticamente.(Substitui CBaseTabbedPane::HasAutoHideMode.)
CTabbedPane::IsTabLocationBottom	Determina se as guias estão localizadas na parte inferior da janela.
CTabbedPane::ResetTabs	Redefine todos os painéis com guias para o estado padrão.
CTabbedPane::SetTabAutoColors	Define uma lista de cores personalizadas que pode ser usado quando o recurso de cor automática está ativado.

Membros de dados

Nome	Descrição
CTabbedPane::m_bTabsAlwaysTop	O localização padrão para guias no aplicativo.
CTabbedPane::m_pTabWndRTC	Informações de classe tempo de execução para um personalizado CMFCTabCtrl-derivados do objeto.

Comentários

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

Para especificar guias regulares em vez das guias do Outlook-style, passe o AFX_CBRS_REGULAR_TABS estilo para o CDockablePane::CreateEx método.

Se você criar um painel com guias com guias removíveis, o painel pode ter sido destruído automaticamente pela estrutura, para que você não deve armazenar o ponteiro.Ao obter um apontador para o painel com guias, telefonar o CBasePane::GetParentTabbedPane método.

Exemplo

Neste exemplo, criar um CTabbedPane objeto. Em seguida, usamos CBaseTabbedPane::AddTab Para anexar outras guias.

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 de BAR de controle com guias é usar CDockablePane::AttachToTabWnd. The AttachToTabWnd método cria dinamicamente um objeto de painel com guias usando informações de classe em tempo de execução conjunto por CDockablePane::SetTabbedPaneRTC.

Neste exemplo, criamos um painel com guias dinamicamente, anexe duas guias e tornar a segunda guia não removíveis.

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);