Classe CTabbedPane

Articolo
06/10/2015

Implementa la funzionalità di un riquadro con le schede staccabili.

class CTabbedPane : public CBaseTabbedPane

Membri

Costruttori pubblici

Nome	Descrizione
CTabbedPane::CTabbedPane	Costruttore predefinito.

Metodi pubblici

Nome	Descrizione
CTabbedPane::DetachPane	(Override CBaseTabbedPane::DetachPane).
CTabbedPane::EnableTabAutoColor	Abilita o disabilita la colorazione automatica delle schede.
CTabbedPane::FloatTab	Esegue e un riquadro, ma solo se il riquadro attualmente si trova in una scheda staccabile. (Override CBaseTabbedPane::FloatTab).
CTabbedPane::GetTabArea	Restituisce le dimensioni e la posizione dell'area della scheda nella finestra a schede.
CTabbedPane::GetTabWnd
CTabbedPane::HasAutoHideMode	Determina se il riquadro a schede può essere modificato alla modalità di nascondi automaticamente. (Override CBaseTabbedPane::HasAutoHideMode).
CTabbedPane::IsTabLocationBottom	Determina se le schede risiedono nella parte inferiore della finestra.
CTabbedPane::ResetTabs	Reimposta tutti i riquadri a schede allo stato predefinito.
CTabbedPane::SetTabAutoColors	Imposta un elenco di colori personalizzati da utilizzare quando la funzionalità automatica di colore è abilitata.

Membri di dati

Nome	Descrizione
CTabbedPane::m_bTabsAlwaysTop	Il percorso predefinito per le schede nell'applicazione.
CTabbedPane::m_pTabWndRTC	Per informazioni CMFCTabCtrlpersonalizzato oggetto derivato dalla classe di runtime.

Note

Il framework crea automaticamente un'istanza di questa classe quando un utente aggiunge un riquadro a un altro puntatore sulla barra del titolo del secondo riquadro. Tutti i riquadri a schede creati dal framework hanno un ID di -1.

Per specificare le normali schede anziché le schede in stile Outlook, passare lo stile AFX_CBRS_REGULAR_TABS al metodo CDockablePane::CreateEx.

Se si crea un riquadro a schede nelle schede staccabili, il riquadro può essere eliminato automaticamente dal framework, pertanto non è necessario archiviare il puntatore. Per ottenere un puntatore al riquadro a schede, chiamare il metodo CBasePane::GetParentTabbedPane.

Esempio

In questo esempio viene creato un oggetto CTabbedPane. Successivamente, si utilizza CBaseTabbedPane::AddTab per collegare le schede aggiuntive.

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

Un altro modo per creare un oggetto a schede della barra di controllo è di utilizzare CDockablePane::AttachToTabWnd. Il metodo AttachToTabWnd crea dinamicamente un oggetto a schede il riquadro utilizzando informazioni sulla classe di runtime impostate da CDockablePane::SetTabbedPaneRTC.

In questo esempio che crea dinamicamente il riquadro a schede, che connettere due schede e che semplificano la seconda scheda non staccabile.

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