CMFCTabCtrl, classe

Article
06/10/2015

La classe d' CMFCTabCtrl fournit les fonctionnalités pour un contrôle onglet. Le contrôle onglet affiche une fenêtre ancrable avec les onglets plate ou en trois dimensions à son haut ou bas. Les tabulations peuvent le texte et une image et peuvent changer la couleur si actifs.

class CMFCTabCtrl : public CMFCBaseTabCtrl

Membres

Constructeurs publics

Nom	Description
CMFCTabCtrl::CMFCTabCtrl	Constructeur par défaut.
CMFCTabCtrl::~CMFCTabCtrl	Destructor.

Méthodes publiques

Nom	Description
CMFCTabCtrl::ActivateMDITab	Affiche l'onglet spécifié du contrôle onglet actuel et définit le focus sur cette table.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow	Spécifie si l'infrastructure est de redimensionner la zone cliente de toutes les fenêtres de contrôle onglet lorsqu'un élément de l'interface utilisateur du contrôle onglet change.
CMFCTabCtrl::CalcRectEdit	Dégonfle la taille de la zone spécifiée d'onglet. (Substitutions CMFCBaseTabCtrl::CalcRectEdit.)
CMFCTabCtrl::Create	Crée le contrôle onglet et l'attache à l'objet d' CMFCTabCtrl .
CMFCTabCtrl::CreateObject	Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe.
CMFCTabCtrl::EnableActiveTabCloseButton	Affiche ou masque un bouton FermerX() sur l'onglet actif.
CMFCTabCtrl::EnableInPlaceEdit	Active ou désactive les étiquettes modifiables de l'onglet. (Substitutions CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu	Remplace deux boutons qui mettent défiler les onglets de fenêtre avec un bouton qui ouvre un menu de windows avec onglets.
CMFCTabCtrl::EnsureVisible	Garantit qu'un onglet soit visible.
CMFCTabCtrl::GetDocumentIcon	Récupère le symbole associé à un onglet dans un menu contextuel des fenêtres à onglet.
CMFCTabCtrl::GetFirstVisibleTabNum	Récupère l'index du premier onglet qui est visible dans le contrôle onglet actuel.
CMFCTabCtrl::GetResizeMode	Récupère une valeur qui spécifie comment le contrôle onglet actuel peut être redimensionné.
CMFCTabCtrl::GetScrollBar	Extrait un pointeur vers l'objet de barre de défilement qui est associé au contrôle onglet.
CMFCTabCtrl::GetTabArea	Récupère le rectangle englobant de la zone d'étiquette d'onglet en haut ou en bas du contrôle onglet. (Substitutions CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint	Récupère l'onglet qui contient un point spécifié. (Substitutions CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth	Extrait la largeur maximale d'une table.
CMFCTabCtrl::GetTabsHeight	Extrait la hauteur du domaine d'onglet du contrôle onglet actuel.
CMFCTabCtrl::GetTabsRect	Récupère un rectangle limites que le domaine d'onglet du contrôle onglet actuel. (Substitutions CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass	Utilisé par l'infrastructure pour obtenir un pointeur vers l'objet de CRuntimeClass associé à ce type de classe.
CMFCTabCtrl::GetWndArea	Récupère les limites de la zone cliente du contrôle onglet actuel.
CMFCTabCtrl::HideActiveWindowHorzScrollBar	Masque la barre de défilement horizontale, le cas échéant, de la fenêtre active.
CMFCTabCtrl::HideInactiveWindow	Spécifie si l'infrastructure est d'afficher des fenêtres de contrôle tab inactives.
CMFCTabCtrl::HideNoTabs	Active ou désactive dessiner la zone de l'onglet s'il n'existe aucun onglet visible.
CMFCTabCtrl::HideSingleTab	Active ou désactive dessiner un onglet lors d'une fenêtre avec onglets unique. (Substitutions CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup	Indique si l'onglet actuel d'un contrôle onglet est l'onglet actif à un groupe d'onglets d'interface multidocument.
CMFCTabCtrl::IsActiveTabBoldFont	Indique si le texte de l'onglet actif est restitué à l'aide d'une police de caractère grasse.
CMFCTabCtrl::IsActiveTabCloseButton	Indique si le bouton FermerX() s'affiche sur un onglet actif ou l'angle supérieur droit de la zone de l'onglet.
CMFCTabCtrl::IsDrawFrame	Indique si la fenêtre avec onglets dessine un rectangle de frame autour de les volets incorporés.
CMFCTabCtrl::IsFlatFrame	Indique si le cadre autour de la zone d'onglet est stable ou 3D.
CMFCTabCtrl::IsFlatTab	Indique, de l'apparence des onglets dans le contrôle onglet actuel soit en deux dimensions ou pas.
CMFCTabCtrl::IsLeftRightRounded	Indique si l'apparence du côté gauche et droite d'un onglet dans le contrôle onglet actuel est arrondie.
CMFCTabCtrl::IsMDITabGroup	Indique si le contrôle onglet actuel est contenu dans la zone cliente d'une fenêtre d'interface multidocument.
CMFCTabCtrl::IsOneNoteStyle	Indique si le contrôle onglet actuel est affiché dans le style Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea	Détermine si un point se trouve à l'intérieur de la zone de l'onglet. (Substitutions CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll	Indique si le contrôle onglet actuel a une barre de défilement qui peut faire défiler ses onglets en tant que groupe.
CMFCTabCtrl::IsTabDocumentsMenu	Indique si le contrôle onglet affiche des boutons de défilement ou un bouton qui affiche un menu de windows avec onglets.
CMFCTabCtrl::IsVS2005Style	Indique si les onglets sont affichés dans le style Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle	Spécifie l'apparence des onglets dans le contrôle onglet actuel.
CMFCTabCtrl::MoveTab	Déplace un onglet à une autre position d'onglet. (Substitutions CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter	Appelé par l'infrastructure lorsque le curseur est d'abord glisser dans la fenêtre de contrôle tab.
CMFCTabCtrl::OnDragOver	Appelé par l'infrastructure pendant une opération de glissement lorsque la souris est déplacé sur la fenêtre cible de déplacement. (Substitutions CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu	Affiche un menu contextuel des fenêtres à onglets, attend que l'utilisateur sélectionne un onglet, puis fait à l'onglet sélectionné l'onglet actif.
CMFCTabCtrl::PreTranslateMessage	Traduit des messages de fenêtre pour qu'ils soient distribués aux fonctions Windows de TranslateMessage et de DispatchMessage . (Substitutions CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout	Recalcule la disposition interne du contrôle onglet. (Substitutions CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup	Définit l'onglet actuel d'un contrôle onglet comme onglet actif à un groupe d'onglets d'interface multidocument.
CMFCTabCtrl::SetActiveTab	Lance une table. (Substitutions CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont	Active ou désactive de utilisation d'une police de caractère grasse sur les onglets actifs.
CMFCTabCtrl::SetDrawFrame	Active ou désactive le rectangle du frame de drawinga autour d'une barre incorporée.
CMFCTabCtrl::SetFlatFrame	Spécifie si dessiner un plate ou un frame 3D autour de la zone de l'onglet.
CMFCTabCtrl::SetImageList	Spécifie une liste d'images. (Substitutions CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode	Spécifie comment le contrôle onglet actuel peut être redimensionné et affiche à nouveau le contrôle.
CMFCTabCtrl::SetTabMaxWidth	Spécifie la largeur maximale de l'onglet dans une fenêtre avec onglets.
CMFCTabCtrl::StopResize	Termine la actuelle se redimensionnent l'opération sur le contrôle onglet.
CMFCTabCtrl::SwapTabs	Permute une paire d'onglets. (Substitutions CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar	Dessine une barre de défilement horizontale sur un contrôle onglet qui affiche des onglets à deux dimensions.

Membres de données

Nom	Description
CMFCTabCtrl::m_bEnableActivate	Empêché la vue active du focus perdant lorsqu'un nouvel onglet est inséré et activé.

Notes

Prend en charge de classe d' CMFCTabCtrl :

Styles de contrôle onglet qui incluent 3D, plate, et plate par une barre de défilement horizontale partagée.
Onglets situés en haut ou en bas de la fenêtre.
Onglets qui texte, des images, ou texte et images.
Onglets qui change la couleur lorsque l'onglet est actif.
Modifications de bordure de taille pour les onglets réglables.
Fenêtres à détachables onglet.

La classe d' CMFCTabCtrl peut être utilisé dans une boîte de dialogue, mais est prévue pour les applications qui utilisent ancrer des barres de contrôles comme Microsoft Excel et Visual Studio. Pour plus d'informations, consultez CDockablePane, classe.

Procédez comme suit pour ajouter un redimensionnable, ancrage en le contrôle onglet dans votre application :

Créez une instance de CTabbedPane, classe.
Appelez CDockablePane::Create.
Utilisez CBaseTabbedPane::AddTab ou CMFCBaseTabCtrl::InsertTab pour ajouter de nouveaux onglets.
Appelez CBasePane::EnableDocking afin que le contrôle onglet actuel d'ancrage puisse l'ancrer à la fenêtre frame principale.
Appelez CFrameWndEx::DockPane pour ancrer la fenêtre avec onglets au frame principal.

Pour obtenir un exemple de création d'une fenêtre avec onglets comme une barre de contrôles d'ancrage, consultez CTabbedPane, classe. Pour utiliser CMFCTabCtrl comme un contrôle non ancrage, créez un objet d' CMFCTabCtrl puis appelez CMFCTabCtrl::Create.

Hiérarchie d'héritage

Exemple

L'exemple suivant montre comment utiliser différentes méthodes dans la classe d' CMFCTabCtrl pour configurer un objet d' CMFCTabCtrl . L'exemple montre comment ajouter un onglet, afficher le bouton Fermer sur l'onglet actif, activer les étiquettes modifiables de l'onglet, puis afficher un menu contextuel des étiquettes de fenêtre avec onglets. Cet exemple est extrait d' Exemple de collection d'état.

 CMFCTabCtrl m_wndTabs;


...


    // Attach list windows to tab: 
    // CListCtrl m_wndList1 
    // CListCtrl m_wndList2 
    // CListCtrl m_wndList3
    m_wndTabs.AddTab (&m_wndList1, _T("Output 1"), (UINT)-1);
    m_wndTabs.AddTab (&m_wndList2, _T("Output 2"), (UINT)-1);
    m_wndTabs.AddTab (&m_wndList3, _T("Output 3"), (UINT)-1);

    m_wndTabs.EnableActiveTabCloseButton();
    m_wndTabs.EnableInPlaceEdit(true);
    m_wndTabs.EnableTabDocumentsMenu();
    m_wndTabs.SetActiveTab(1);
    m_wndTabs.SetDrawFrame();
    m_wndTabs.SetFlatFrame();