CTabbedPane, classe

Article
06/10/2015

Implémente les fonctionnalités d'un volet avec les onglets détachables.

class CTabbedPane : public CBaseTabbedPane

Membres

Constructeurs publics

Nom	Description
CTabbedPane::CTabbedPane	Constructeur par défaut.

Méthodes publiques

Nom	Description
CTabbedPane::DetachPane	(Substitutions CBaseTabbedPane::DetachPane.)
CTabbedPane::EnableTabAutoColor	Active ou désactive la coloration automatique des onglets.
CTabbedPane::FloatTab	Flotte un volet, mais uniquement si le volet se trouve actuellement dans une table détachable. (Substitutions CBaseTabbedPane::FloatTab.)
CTabbedPane::GetTabArea	Retourne la taille et la position de la zone de l'onglet dans la fenêtre à onglet.
CTabbedPane::GetTabWnd
CTabbedPane::HasAutoHideMode	Détermine si le volet à onglets peut être basculé pour masquer automatiquement le mode. (Substitutions CBaseTabbedPane::HasAutoHideMode.)
CTabbedPane::IsTabLocationBottom	Détermine si les onglets se trouvent en bas de la fenêtre.
CTabbedPane::ResetTabs	Réinitialise tous les volets avec onglets à l'état par défaut.
CTabbedPane::SetTabAutoColors	Définit une liste de couleurs personnalisées qui peuvent être utilisées lorsque la fonctionnalité automatique de couleur est activée.

Membres de données

Nom	Description
CTabbedPane::m_bTabsAlwaysTop	L'emplacement par défaut pour les onglets présents dans l'application.
CTabbedPane::m_pTabWndRTC	Les informations de classe d'exécution pour un personnalisé CMFCTabCtrlobjet dérivé.

Notes

L'infrastructure crée automatiquement une instance de cette classe lorsqu'un utilisateur joint un volet à un autre en pointant sur la légende du deuxième volet. Tous les volets avec onglets qui sont créés par l'infrastructure ont un ID de -1.

Pour spécifier les onglets normaux au lieu des onglets du style Outlook, passez le style d' AFX_CBRS_REGULAR_TABS à la méthode de CDockablePane::CreateEx .

Si vous créez un volet à onglets avec les onglets détachables, le volet peut être détruit automatiquement par l'infrastructure, vous ne devez pas stocker le pointeur. Pour obtenir un pointeur vers le volet à onglets, appelez la méthode d' CBasePane::GetParentTabbedPane .

Exemple

Dans cet exemple nous créons un objet d' CTabbedPane . Ensuite, nous utilisons CBaseTabbedPane::AddTab pour attacher les onglets supplémentaires.

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

Une autre méthode pour créer un objet avec onglets de la barre de contrôles est d'utiliser CDockablePane::AttachToTabWnd. La méthode d' AttachToTabWnd crée dynamiquement un objet avec onglet du volet utilisation de positions d'informations de classe d'exécution par CDockablePane::SetTabbedPaneRTC.

Dans cet exemple que nous créons un volet à onglets dynamiquement, joignons deux onglets, et rendons le deuxième onglet non détachable.

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