Share via

La classe CMFCTabCtrl

  • Article

La CMFCTabCtrl classe fournit des fonctionnalités pour un contrôle tabulation. Le contrôle onglet affiche une fenêtre ancrable avec des onglets plats ou tridimensionnels en haut ou en bas. Les onglets peuvent afficher un texte et une image et peuvent changer de couleur en cas d'activation.

Syntaxe

class CMFCTabCtrl : public CMFCBaseTabCtrl

Membres

Constructeurs publics

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

Méthodes publiques

Nom Description
CMFCTabCtrl::ActivateMDITab Affiche l’onglet spécifié du contrôle onglet actif et définit le focus sur cet onglet.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow Spécifie si l’infrastructure doit redimensionner la zone cliente de toutes les fenêtres de contrôle onglet lorsqu’un élément d’interface utilisateur du contrôle tabulation change.
CMFCTabCtrl::CalcRectEdit Défle la taille de la zone d’onglet spécifiée. (remplace CMFCBaseTabCtrl::CalcRectEdit).
CMFCTabCtrl::Create Crée le contrôle Tab et l’attache à l’objet 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 Fermer ( X) sous l’onglet actif.
CMFCTabCtrl::EnableInPlaceEdit Active ou désactive les étiquettes d’onglet modifiables. (Substitue CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu Remplace deux boutons qui défilent les onglets de la fenêtre par un bouton qui ouvre un menu de fenêtres à onglets.
CMFCTabCtrl::EnsureVisible Garantit qu’un onglet est visible.
CMFCTabCtrl::GetDocumentIcon Récupère le symbole associé à un onglet dans un menu contextuel de fenêtres à onglets.
CMFCTabCtrl::GetFirstVisibleTabNum Récupère l’index du premier onglet visible dans le contrôle onglet actif.
CMFCTabCtrl::GetResizeMode Récupère une valeur qui spécifie la façon dont le contrôle tabulation actuel peut être redimensionné.
CMFCTabCtrl::GetScrollBar Récupère un pointeur vers l’objet de barre de défilement associé au contrôle Tab.
CMFCTabCtrl::GetTabArea Récupère le rectangle englobant de la zone d’étiquette d’onglet en haut ou en bas du contrôle Tab. (Substitue CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint Récupère l’onglet qui contient un point spécifié. (Substitue CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth Récupère la largeur maximale d’un onglet.
CMFCTabCtrl::GetTabsHeight Récupère la hauteur de la zone d’onglet du contrôle onglet actif.
CMFCTabCtrl::GetTabsRect Récupère un rectangle qui limite la zone de tabulation du contrôle tabulation actif. (Substitue CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass Utilisé par l’infrastructure pour obtenir un pointeur vers l’objet CRuntimeClass associé à ce type de classe.
CMFCTabCtrl::GetWndArea Récupère la limite de la zone cliente du contrôle tabulation 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 doit afficher les fenêtres de contrôle onglet inactives.
CMFCTabCtrl::HideNoTabs Active ou désactive le dessin de la zone d’onglet en l’absence d’onglets visibles.
CMFCTabCtrl::HideSingleTab Active ou désactive le dessin d’un onglet lorsqu’il existe une fenêtre à onglet unique. (Substitue CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup Indique si l’onglet actuel d’un contrôle Onglet est l’onglet actif d’un groupe d’onglets d’interface de document multiple.
CMFCTabCtrl::IsActiveTabBoldFont Indique si le texte de l’onglet actif s’affiche à l’aide d’une police en gras.
CMFCTabCtrl::IsActiveTabCloseButton Indique si le bouton Fermer ( X) s’affiche sous un onglet actif ou dans le coin supérieur droit de la zone d’onglet.
CMFCTabCtrl::IsDrawFrame Indique si la fenêtre à onglets dessine un rectangle de cadre autour des volets incorporés.
CMFCTabCtrl::IsFlatFrame Indique si le cadre autour de la zone de tabulation est plat ou 3D.
CMFCTabCtrl::IsFlatTab Indique si l’apparence des onglets dans le contrôle onglet actif est plate ou non.
CMFCTabCtrl::IsLeftRightRounded Indique si l’apparence du côté gauche et droit d’un onglet dans le contrôle tabulation actuel est arrondie.
CMFCTabCtrl::IsMDITabGroup Indique si le contrôle tabulation actuel est contenu dans la zone cliente d’une fenêtre d’interface à plusieurs documents.
CMFCTabCtrl::IsOneNoteStyle Indique si le contrôle onglet actuel est affiché dans le style de Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea Détermine si un point se trouve à l’intérieur de la zone d’onglet. (Substitue CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll Indique si le contrôle tabulation actuel a une barre de défilement qui peut faire défiler ses onglets sous forme de groupe.
CMFCTabCtrl::IsTabDocumentsMenu Indique si le contrôle Tab affiche des boutons de défilement ou un bouton qui affiche un menu de fenêtres à onglets.
CMFCTabCtrl::IsVS2005Style Indique si les onglets sont affichés dans le style de Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle Spécifie l’apparence des onglets dans le contrôle onglet actif.
CMFCTabCtrl::MoveTab Déplace un onglet vers une autre position d’onglet. (Substitue CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter Appelé par l’infrastructure lorsque le curseur est d’abord déplacé dans la fenêtre de contrôle tabulation.
CMFCTabCtrl::OnDragOver Appelé par l’infrastructure pendant une opération de glissement lorsque la souris est déplacée sur la fenêtre cible de déplacement. (Substitue CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu Affiche un menu contextuel de fenêtres à onglets, attend que l’utilisateur sélectionne un onglet et le fait de l’onglet sélectionné l’onglet actif.
CMFCTabCtrl::PreTranslateMessage Traduit les messages de fenêtre avant qu’ils ne soient distribués aux TranslateMessage fonctions Windows.DispatchMessage (Substitue CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout Recalcule la disposition interne du contrôle Tab. (Substitue CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup Définit l’onglet actif d’un contrôle Tab comme onglet actif dans un groupe d’onglets d’interface de document multiple.
CMFCTabCtrl::SetActiveTab Active un onglet. (Substitue CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont Active ou désactive l’utilisation d’une police en gras sur les onglets actifs.
CMFCTabCtrl::SetDrawFrame Active ou désactive le dessin d’un rectangle de cadre autour d’une barre incorporée.
CMFCTabCtrl::SetFlatFrame Spécifie s’il faut dessiner un cadre plat ou 3D autour de la zone de tabulation.
CMFCTabCtrl::SetImageList Spécifie une liste d’images. (Substitue CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode Spécifie comment le contrôle tabulation actuel peut être redimensionné, puis réaffiche le contrôle.
CMFCTabCtrl::SetTabMaxWidth Spécifie la largeur maximale de tabulation dans une fenêtre à onglets.
CMFCTabCtrl::StopResize Met fin à l’opération de redimensionnement actuelle sur le contrôle Tab.
CMFCTabCtrl::SwapTabs Échange une paire d’onglets. (Substitue CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar Dessine une barre de défilement horizontale sur un contrôle tabulation qui affiche des onglets plats.

Données membres

Nom Description
CMFCTabCtrl::m_bEnableActivate Empêche l’affichage actif de perdre le focus lorsqu’un nouvel onglet est inséré et activé.

Notes

La CMFCTabCtrl classe prend en charge :

  • Styles de contrôle Tab qui incluent 3D, plat et plat avec une barre de défilement horizontale partagée.

  • Onglets situés en haut ou en bas de la fenêtre.

  • Onglets qui affichent du texte, des images ou du texte et des images.

  • Onglets qui changent de couleur lorsque l’onglet est actif.

  • La taille de la bordure change pour les onglets réglables.

  • Fenêtres à onglets détachables.

La CMFCTabCtrl classe peut être utilisée avec une boîte de dialogue, mais elle est destinée aux applications qui utilisent des barres de contrôle d’ancrage telles que Microsoft Excel et Visual Studio. Pour plus d’informations, consultez CDockablePane Classe.

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

  1. Créez une instance de CTabbedPane classe.

  2. Appelez CDockablePane::Create.

  3. Utilisez CBaseTabbedPane::AddTab ou CMFCBaseTabCtrl::InsertTab ajoutez de nouveaux onglets.

  4. Appelez CBasePane::EnableDocking pour que le contrôle d’onglet d’ancrage actuel puisse s’ancrer dans la fenêtre de trame principale.

  5. Appelez CFrameWndEx::DockPane pour ancrer la fenêtre à onglets au niveau du cadre principal.

Pour obtenir un exemple de création d’une fenêtre à onglets sous forme de barre de contrôle d’ancrage, consultez CTabbedPane Classe. Pour utiliser CMFCTabCtrl comme contrôle d’ancrage non ancré, créez un CMFCTabCtrl objet, puis appelez CMFCTabCtrl::Create.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Exemple

L’exemple suivant montre comment utiliser différentes méthodes dans la CMFCTabCtrl classe pour configurer un CMFCTabCtrl objet. L’exemple explique comment ajouter un onglet, afficher le bouton Fermer sous l’onglet actif, activer les étiquettes d’onglet modifiables et afficher un menu contextuel d’étiquettes de fenêtres à onglets. Cet exemple fait partie de l’exemple State Collection.

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

Spécifications

En-têteafxtabctrl.h:

CMFCTabCtrl::ActivateMDITab

Affiche l’onglet spécifié du contrôle onglet actif et définit le focus sur cet onglet.

void ActivateMDITab(int nTab = -1);

Paramètres

nTab
[in] Index de base zéro d’un onglet à afficher, ou -1 pour spécifier l’onglet actif actuellement.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Pour plus d’informations, consultez le code source situé dans le mfc dossier de votre installation de Visual Studio. Par exemple, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Valeur de retour

A toujours la valeur TRUE.

Notes

CMFCTabCtrl::AutoSizeWindow

Spécifie si l’infrastructure doit redimensionner la zone cliente de toutes les fenêtres de contrôle onglet lorsqu’un élément d’interface utilisateur du contrôle tabulation change.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Paramètres

bAutoSize
[in] TRUE pour redimensionner automatiquement les fenêtres de contrôle tabulation ; sinon, FALSE. La valeur par défaut est TRUE.

Notes

CMFCTabCtrl::Create

Crée le contrôle Tab et l’attache à l’objet CMFCTabCtrl .

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

Paramètres

style
[in] Style du contrôle Tab. Pour plus d'informations, consultez la section Notes.

rect
[in] Rectangle qui limite le contrôle Tab.

pParentWnd
[in] Pointeur vers une fenêtre parente. Ne doit pas être NULL.

nID
[in] ID du contrôle Tab.

location
[in] Emplacement des onglets. La valeur par défaut est LOCATION_BOTTOM. Pour plus d’informations, consultez Notes.

bCloseBtn
[in] TRUE pour afficher un bouton fermer sous l’onglet ; sinon, FALSE. La valeur par défaut est FALSE.

Valeur de retour

TRUE en cas de réussite ; sinon, FALSE.

Notes

Le tableau suivant décrit les valeurs que vous pouvez spécifier pour le style paramètre.

Style Description
STYLE_3D Crée un contrôle tabulation avec une apparence tridimensionnelle.
STYLE_FLAT Crée un contrôle tabulation avec des onglets plats.
STYLE_FLAT_SHARED_HORZ_SCROLL Crée un contrôle tabulation avec des onglets plats et une barre de défilement qui peut faire défiler les onglets s’ils sont coupés par une fenêtre parente.
STYLE_3D_ONENOTE Crée un contrôle tabulation dans le style de Microsoft OneNote.
STYLE_3D_VS2005 Crée un contrôle tabulation dans le style de Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED Crée un contrôle tabulation avec des onglets arrondis dans le style de Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL Crée un contrôle tabulation avec des onglets arrondis et des boutons de défilement dans le style de Microsoft Visual Studio 2005.

Le tableau suivant répertorie les valeurs que vous pouvez spécifier pour le location paramètre.

Emplacement Description
LOCATION_BOTTOM Les onglets se trouvent en bas du contrôle Tab.
LOCATION_TOP Les onglets se trouvent en haut du contrôle Tab.

Exemple

L’exemple suivant montre comment utiliser la Create méthode dans la CMFCTabCtrl classe. Cet exemple fait partie de l’exemple State Collection.

CMFCTabCtrl m_wndTabs;

// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

CMFCTabCtrl::CalcRectEdit

Défle la taille de la zone d’onglet spécifiée.

virtual void CalcRectEdit(CRect& rectEdit);

Paramètres

rectEdit
[in] Rectangle qui spécifie la zone d’un onglet.

Notes

Cette méthode est appelée lorsque vous modifiez l’étiquette d’un onglet. Cette méthode défle les côtés gauche et droit du rectangle spécifié d’une moitié de la hauteur de tabulation actuelle, et défle le haut et le bas d’une unité.

CMFCTabCtrl::EnableActiveTabCloseButton

Affiche ou masque un bouton Fermer ( X) sous l’onglet actif.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Paramètres

bEnable
[in] TRUE pour afficher le bouton Fermer sous l’onglet actif ; FALSE pour afficher le bouton Fermer dans le coin supérieur droit de la zone d’onglet. La valeur par défaut est TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Active ou désactive les étiquettes d’onglet modifiables.

virtual void EnableInPlaceEdit(BOOL bEnable);

Paramètres

bEnable
[in] TRUE pour activer les étiquettes d’onglet modifiables ; FALSE pour désactiver les étiquettes d’onglet modifiables.

Notes

CMFCTabCtrl::EnableTabDocumentsMenu

Bascule entre une interface utilisateur qui utilise deux boutons pour faire défiler les onglets de la fenêtre et une interface qui affiche un menu contextuel de fenêtres à onglets.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Paramètres

bEnable
[in] TRUE pour afficher un menu contextuel d’étiquettes de fenêtre à onglets ; FALSE pour afficher les boutons de défilement vers l’avant et l’arrière. La valeur par défaut est TRUE.

Notes

Lorsque l’utilisateur clique sur une étiquette d’onglet, l’infrastructure affiche la fenêtre à onglets correspondante. Si l’étiquette de tabulation est visible, la fenêtre à onglets est ouverte sans modifier sa position. Si l’utilisateur sélectionne un document dans le menu contextuel et que la fenêtre à onglets correspondante est désactivée, la fenêtre à onglets devient le premier onglet.

CMFCTabCtrl::EnsureVisible

Garantit qu’un onglet est visible.

virtual BOOL EnsureVisible(int iTab);

Paramètres

iTab
[in] Index de base zéro d’un onglet.

Valeur de retour

TRUE si elle réussit ; FALSE si l’index de iTab paramètre n’est pas valide.

Notes

Utilisez cette méthode pour garantir que l’onglet spécifié est visible. Le contrôle Tab défile s’il est nécessaire.

CMFCTabCtrl::GetDocumentIcon

Récupère l’image associée à un onglet dans un menu contextuel de fenêtres à onglets.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Paramètres

nCmdID
[in] ID de commande d’un onglet dans un menu contextuel de fenêtres à onglets.

Valeur de retour

Handle d’une image bitmap.

CMFCTabCtrl::GetFirstVisibleTabNum

Récupère l’index du premier onglet visible dans le contrôle onglet actif.

virtual int GetFirstVisibleTabNum() const;

Valeur de retour

Index de base zéro d’un onglet dans le contrôle Tab.

Notes

Utilisez cette méthode uniquement lorsque le contrôle tabulation est affiché dans le style de Microsoft OneNote. Utilisez la CMFCTabCtrl::IsOneNoteStyle méthode pour déterminer le style.

CMFCTabCtrl::GetResizeMode

Récupère une valeur qui spécifie la façon dont le contrôle tabulation actuel peut être redimensionné.

ResizeMode GetResizeMode() const;

Valeur de retour

Une des valeurs d’énumération CMFCTabCtrl::ResizeMode qui spécifie la façon dont le contrôle tabulation peut être redimensionné. Pour obtenir la liste des valeurs possibles, consultez la section Notes de la CMFCTabCtrl::SetResizeMode méthode.

CMFCTabCtrl::GetScrollBar

Récupère un pointeur vers l’objet de barre de défilement associé au contrôle Tab.

CScrollBar* GetScrollBar();

Valeur de retour

Pointeur vers un objet de barre de défilement ou si NULL le contrôle Tab n’a pas été créé à l’aide du STYLE_FLAT_SHARED_HORZ_SCROLL style.

Notes

Utilisez cette méthode pour accéder à la barre de défilement incorporée du contrôle Tab. Un objet de barre de défilement est créé uniquement lorsque le contrôle tabulation a le STYLE_FLAT_SHARED_HORZ_SCROLL style.

CMFCTabCtrl::GetTabArea

Récupère le rectangle englobant de la zone d’étiquette d’onglet en haut ou en bas du contrôle Tab.

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Paramètres

rectTabAreaTop
[out] Lorsque cette méthode est retournée, cette référence contient un rectangle qui limite la zone d’étiquette de l’onglet supérieur. Le rectangle se trouve dans les coordonnées du client. Cette référence est vide si aucune zone d’étiquette d’onglet n’existe en haut du contrôle Tab.

rectTabAreaBottom
[out] Lorsque cette méthode est retournée, cette référence contient un rectangle qui limite la zone d’étiquette de l’onglet inférieur. Le rectangle se trouve dans les coordonnées du client. Cette référence est vide si aucune zone d’étiquette d’onglet n’existe en bas du contrôle Tab.

Notes

Utilisez cette méthode pour déterminer la taille et la position de la zone d’onglet dans la fenêtre à onglets.

CMFCTabCtrl::GetTabMaxWidth

Récupère la largeur maximale d’un onglet.

int GetTabMaxWidth() const;

Valeur de retour

Largeur maximale d’un onglet, en pixels. Si la valeur de retour est 0, la largeur de tabulation est illimitée.

Notes

Utilisez la méthode CMFCTabCtrl ::SetTabMaxWidth pour définir la largeur de tabulation maximale.

CMFCTabCtrl::GetTabsHeight

Récupère la hauteur de la zone d’onglet du contrôle onglet actif.

virtual int GetTabsHeight() const;

Valeur de retour

Hauteur de la zone d’onglet si un onglet est visible ou zéro si aucun onglet n’est visible.

CMFCTabCtrl::GetTabsRect

Récupère un rectangle qui limite la zone de tabulation du contrôle tabulation actif.

virtual void GetTabsRect(CRect& rect) const;

Paramètres

rect
[out] Lorsque cette méthode est retournée, le rect paramètre contient un rectangle qui limite la zone d’onglet.

CMFCTabCtrl::GetWndArea

Récupère la limite de la zone cliente du contrôle tabulation actuel.

void GetWndArea(CRect& rect) const;

Paramètres

rect
[in, out] Lorsque cette méthode est retournée, ce paramètre contient un rectangle qui limite le contrôle tabulation actuel.

Notes

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Masque la barre de défilement horizontale, le cas échéant, dans la fenêtre active.

void HideActiveWindowHorzScrollBar();

Notes

Utilisez cette méthode pour empêcher le contrôle tabulation de clignoter lorsque l’utilisateur bascule entre les pages de contrôle tabulation.

CMFCTabCtrl::HideInactiveWindow

Spécifie si l’infrastructure affiche les fenêtres de contrôle d’onglet inactives.

void HideInactiveWindow(BOOL bHide = TRUE);

Paramètres

bHide
[in] TRUE ne pas afficher de fenêtre inactive ; FALSE pour afficher une fenêtre inactive. La valeur par défaut est TRUE.

Notes

CMFCTabCtrl::HideNoTabs

Active ou désactive le dessin de la zone d’onglet s’il n’y a pas d’onglets visibles.

void HideNoTabs(BOOL bHide=TRUE);

Paramètres

bHide
[in] TRUE pour activer le dessin de la zone d’onglet ; FALSE pour désactiver le dessin. La valeur par défaut est TRUE.

Notes

CMFCTabCtrl::HideSingleTab

Active ou désactive le dessin d’onglets s’il existe une seule fenêtre à onglets.

virtual void HideSingleTab(BOOL bHide=TRUE);

Paramètres

bHide
[in] TRUE pour ne pas dessiner un onglet pour une seule fenêtre à onglets ; FALSE pour dessiner un seul onglet. La valeur par défaut est TRUE.

Notes

CMFCTabCtrl::IsActiveInMDITabGroup

Indique si l’onglet actuel d’un contrôle Onglet est l’onglet actif d’un groupe d’onglets d’interface de document multiple.

BOOL IsActiveInMDITabGroup() const;

Valeur de retour

TRUE si l’onglet actif d’un contrôle Onglet est l’onglet actif dans un groupe d’onglets MDI ; sinon, FALSE.

Notes

Vous pouvez organiser plusieurs fenêtres de document en groupes d’onglets verticaux ou horizontaux et facilement mélanger des documents d’un groupe d’onglets à un autre.

CMFCTabCtrl::IsActiveTabBoldFont

Indique si le texte de l’onglet actif s’affiche à l’aide d’une police en gras.

BOOL IsActiveTabBoldFont() const;

Valeur de retour

TRUE si l’onglet actif s’affiche à l’aide de la police en gras ; sinon, FALSE.

Notes

Utilisez la CMFCTabCtrl::SetActiveTabBoldFont méthode pour modifier la police d’onglet actif.

CMFCTabCtrl::IsActiveTabCloseButton

Indique si le bouton Fermer ( X) s’affiche sous un onglet actif ou dans le coin supérieur droit de la zone d’onglet.

virtual BOOL IsActiveTabCloseButton() const;

Valeur de retour

TRUE si le bouton Fermer s’affiche sous l’onglet actif ; FALSE si le bouton Fermer s’affiche dans le coin supérieur droit de la zone d’onglet.

Notes

CMFCTabCtrl::IsDrawFrame

Indique si la fenêtre à onglets dessine un rectangle de cadre autour des volets incorporés.

BOOL IsDrawFrame() const;

Valeur de retour

TRUE si un rectangle de cadre est dessiné ; sinon, FALSE.

Notes

Utilisez la CMFCTabCtrl::SetDrawFrame méthode pour activer ou désactiver le dessin d’un rectangle de cadre.

CMFCTabCtrl::IsFlatFrame

Indique si le cadre autour de la zone de tabulation est plat ou 3D.

BOOL IsFlatFrame() const;

Valeur de retour

TRUE si le cadre autour de la zone de tabulation est plat ; FALSE si le cadre est tridimensionnel.

Notes

Utilisez la CMFCTabCtrl::SetFlatFrame méthode pour modifier la façon dont le frame est dessiné.

CMFCTabCtrl::IsFlatTab

Indique si l’apparence des onglets dans le contrôle onglet actif est plate ou non.

virtual BOOL IsFlatTab() const;

Valeur de retour

TRUE si l’apparence des onglets dans le contrôle tabulation actif est plate ; sinon, FALSE.

CMFCTabCtrl::IsLeftRightRounded

Indique si l’apparence du côté gauche et droit d’un onglet dans le contrôle tabulation actuel est arrondie.

virtual BOOL IsLeftRightRounded() const;

Valeur de retour

TRUE si les côtés de chaque onglet sont arrondis ; sinon, FALSE.

CMFCTabCtrl::IsMDITabGroup

Indique si le contrôle tabulation actuel est contenu dans la zone cliente d’une fenêtre d’interface à plusieurs documents.

virtual BOOL IsMDITabGroup() const;

Valeur de retour

TRUE si le contrôle tabulation actuel se trouve dans une fenêtre de zone cliente MDI ; sinon, FALSE.

CMFCTabCtrl::IsOneNoteStyle

Indique si le contrôle onglet actuel est affiché dans le style de Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Valeur de retour

TRUE si le contrôle tabulation s’affiche dans le style de Microsoft OneNote ; sinon, FALSE.

CMFCTabCtrl::IsSharedScroll

Indique si le contrôle tabulation actuel a une barre de défilement qui peut faire défiler ses onglets sous forme de groupe.

BOOL IsSharedScroll() const;

Valeur de retour

TRUE si le contrôle Tab a une barre de défilement partagée ; sinon, FALSE.

Notes

Cette méthode retourne TRUE si le style paramètre de la CMFCTabCtrl::Create méthode est STYLE_FLAT_SHARED_HORZ_SCROLL.

CMFCTabCtrl::IsTabDocumentsMenu

Indique si le contrôle Tab affiche des boutons de défilement ou un bouton qui affiche un menu de fenêtres à onglets.

BOOL IsTabDocumentsMenu() const;

Valeur de retour

TRUE si les fenêtres à onglets font défiler l’écran à l’aide d’un menu contextuel d’étiquettes de fenêtres à onglets ; FALSE si les fenêtres à onglets font défiler l’écran à l’aide de boutons de défilement vers l’avant et vers l’arrière.

Notes

Utilisez la CMFCTabCtrl::EnableTabDocumentsMenu méthode pour spécifier la méthode de défilement des fenêtres à onglets.

CMFCTabCtrl::IsVS2005Style

Indique si les onglets sont dessinés à l’aide du style de Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Valeur de retour

TRUE si les onglets sont dessinés à l’aide du style de Visual Studio 2005 ; sinon, FALSE.

Notes

Utilisez le style paramètre de la CMFCTabCtrl::Create méthode pour spécifier la façon dont les onglets sont dessinés.

CMFCTabCtrl::m_bEnableActivate

Empêche l’affichage actif de perdre le focus lorsqu’un nouvel onglet est inséré et activé.

static BOOL m_bEnableActivate;

Notes

Le focus est généralement pris par une nouvelle fenêtre à onglets lorsque l’onglet est inséré et rendu actif. Définissez la CMFCTabCtrl::m_bEnableActivate variable membre pour FALSE conserver le focus d’origine. La valeur par défaut est TRUE.

CMFCTabCtrl::ModifyTabStyle

Spécifie l’apparence des onglets dans le contrôle onglet actif.

BOOL ModifyTabStyle(Style style);

Paramètres

style
[in] Une des valeurs d’énumération qui spécifie l’apparence du contrôle Tab. Pour plus d’informations, consultez le tableau des remarques.

Valeur de retour

A toujours la valeur TRUE.

Notes

La valeur du style paramètre peut être l’une des énumérations suivantes CMFCTabCtrl::Style .

Nom Description
STYLE_3D Affiche des onglets rectangulaires à trois dimensions qui ont des angles arrondis.
STYLE_3D_ONENOTE Affiche des onglets à trois dimensions qui ont un côté vertical et un côté incliné et qui ont des angles arrondis.
STYLE_3D_ROUNDED Affiche des onglets tridimensionnels qui ont des côtés inclinés et des angles arrondis.
STYLE_3D_ROUNDED_SCROLL Affiche des onglets tridimensionnels qui ont des côtés inclinés et des angles arrondis. S’il existe plus d’onglets que possible en même temps, l’infrastructure affiche une flèche déroulante et un menu d’onglets à activer.
STYLE_3D_SCROLLED Affiche des onglets rectangulaires à trois dimensions. S’il existe plus d’onglets que possible en même temps, l’infrastructure affiche une flèche déroulante et un menu d’onglets à activer.
STYLE_3D_VS2005 Affiche des onglets tridimensionnels arrondis qui ont un côté incliné et un côté vertical.
STYLE_FLAT Affiche des onglets à deux dimensions qui ont des côtés gauche et droit inclinés.
STYLE_FLAT_SHARED_HORZ_SCROLL Affiche des onglets à deux dimensions. S’il y a plus d’onglets que possible en même temps, le framework affiche des flèches de défilement aux extrémités de la zone d’onglet.

CMFCTabCtrl::OnDragEnter

Appelé par l’infrastructure pendant une opération de glisser-déplacer lorsque le curseur entre d’abord dans la fenêtre du contrôle tabulation actif.

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Paramètres

pDataObject
[in] Pointe vers un objet de données qui contient des données que l’utilisateur fait glisser.

dwKeyState
[in] Contient l’état des touches de modificateur. Ce paramètre est une combinaison au niveau du bit « ou » (|) des valeurs suivantes : MK_CONTROL, , MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTONet MK_RBUTTON. Pour plus d’informations, consultez la section Paramètres du message sur l’entrée de la souris.

point
[in] Contient l’emplacement actuel du curseur dans les coordonnées du client.

Valeur de retour

Toujours DROPEFFECT_NONE, ce qui signifie que la cible de suppression ne peut pas accepter les données.

Notes

Utilisez cette méthode pour prendre en charge une opération de glisser-déplacer. Remplacez cette méthode pour implémenter votre propre comportement personnalisé.

Par défaut, cette méthode appelle CMFCTabCtrl::OnDragOveruniquement , qui retourne DROPEFFECT_NONEtoujours .

CMFCTabCtrl::OnDragOver

Appelé par l’infrastructure pendant une opération de glissement lorsque la souris est déplacée sur la fenêtre cible de déplacement.

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Paramètres

pDataObject
[in] Pointeur vers un COleDataObject objet qui est déplacé sur la cible de déplacement.

dwKeyState
[in] État des touches de modificateur, qui est une combinaison au niveau du bit « ou » (|) de MK_CONTROL, , MK_SHIFTMK_ALT, MK_LBUTTON, , MK_MBUTTONet MK_RBUTTON. Pour plus d’informations, consultez « Paramètres de message » dans À propos de l’entrée de la souris.

point
[in] Position actuelle de la souris.

Valeur de retour

A toujours la valeur DROPEFFECT_NONE.

Notes

Remplacez cette méthode par votre implémentation personnalisée. Pour plus d'informations, voir la méthode CView::OnDragOver.

CMFCTabCtrl::OnShowTabDocumentsMenu

Affiche un menu contextuel de fenêtres à onglets, attend que l’utilisateur sélectionne un onglet et le fait de l’onglet sélectionné l’onglet actif.

virtual void OnShowTabDocumentsMenu(CPoint point);

Paramètres

point
[in] Coordonnées de l’emplacement où afficher le menu contextuel.

Notes

CMFCTabCtrl::SetActiveInMDITabGroup

Définit l’onglet actif d’un contrôle Tab comme onglet actif dans un groupe d’onglets d’interface de document multiple.

void SetActiveInMDITabGroup(BOOL bActive);

Paramètres

bActive
[in] TRUE pour que l’onglet actif soit l’onglet actif ; FALSE pour rendre l’onglet actif inactif.

Notes

Vous pouvez organiser plusieurs fenêtres de document en groupes d’onglets verticaux ou horizontaux et facilement mélanger des documents d’un groupe d’onglets à un autre.

CMFCTabCtrl::SetActiveTab

Active un onglet.

virtual BOOL SetActiveTab(int iTab);

Paramètres

iTab
[in] Spécifie l’index de base zéro de l’onglet à activer.

Valeur de retour

TRUE si l’onglet spécifié a été activé ; FALSE si la valeur de paramètre spécifiée iTab n’est pas valide.

Notes

Cela envoie la AFX_WM_CHANGE_ACTIVE_TAB notification à la fenêtre parente et au cadre du contrôle tabulation du parent.

La SetActiveTab méthode appelle automatiquement la CMFCTabCtrl::HideActiveWindowHorzScrollBar méthode pour empêcher l’écran de clignoter.

CMFCTabCtrl::SetActiveTabBoldFont

Active ou désactive l’utilisation d’une police en gras sur les onglets actifs.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Paramètres

bIsBold
[in] TRUE pour utiliser une police en gras pour afficher l’étiquette de l’onglet actif ; FALSE pour utiliser la police standard pour afficher l’étiquette. La valeur par défaut est TRUE.

Notes

CMFCTabCtrl::SetDrawFrame

Spécifie si un rectangle de cadre est dessiné autour d’une barre incorporée.

void SetDrawFrame(BOOL bDraw=TRUE);

Paramètres

bDraw
[in] TRUE pour afficher un rectangle de cadre autour d’une barre incorporée ; sinon, FALSE. La valeur par défaut est TRUE.

Notes

CMFCTabCtrl::SetFlatFrame

Spécifie s’il faut dessiner un cadre plat ou 3D autour de la zone de tabulation.

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

Paramètres

bFlat
[in] TRUE pour dessiner un cadre plat (2D) autour de la zone de tabulation ; FALSE pour dessiner un cadre tridimensionnel (3D). La valeur par défaut est TRUE.

bRepaint
[in] TRUE pour redessiner immédiatement la fenêtre ; sinon, FALSE. La valeur par défaut est TRUE.

Notes

CMFCTabCtrl::SetImageList

Spécifie une liste d’images.

virtual BOOL SetImageList(
    UINT uiID,
    int cx=15,
    COLORREF clrTransp=RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

Paramètres

uiID
[in] ID d’une ressource bitmap qui contient la liste d’images.

cx
[in] Largeur de chaque image, en pixels. La valeur par défaut est 15.

clrTransp
[in] Couleur transparente de l’image. Les parties de l’image qui sont cette couleur seront transparentes. La valeur par défaut est la couleur magenta, RGB(255,0,255).

hImageList
[in] Handle vers une liste d’images préchargée.

Valeur de retour

TRUE si cette méthode réussit. FALSE si le contrôle tabulation est créé à l’aide d’un style plat ou si la première surcharge de méthode ne peut pas charger la bitmap spécifiée par le uiID paramètre.

Notes

Utilisez cette méthode pour définir une liste d’images pour le contrôle tabulation. Les images de la liste d’images sont affichées en regard de l’étiquette de tabulation. Cette méthode recalcule la hauteur de tabulation afin que l’onglet soit dimensionné pour contenir à la fois l’image et le texte.

Utilisez la CMFCBaseTabCtrl::AddTab méthode héritée par le contrôle Tab pour spécifier l’index de l’image à afficher.

CMFCTabCtrl::SetResizeMode

Spécifie comment le contrôle tabulation actuel peut être redimensionné, puis réaffiche le contrôle.

void SetResizeMode(ResizeMode resizeMode);

Paramètres

resizeMode
[in] Une des valeurs d’énumération CMFCTabCtrl::ResizeMode qui spécifie la façon dont le contrôle tabulation peut être redimensionné. Pour obtenir la liste des valeurs possibles, consultez le tableau dans Notes.

Notes

Le paramètre resizeMode peut être l’une des valeurs d’énumération suivantes ResizeMode .

Nom Description
RESIZE_NO Impossible de redimensionner le contrôle tabulation.
RESIZE_VERT Le contrôle Tab peut être redimensionné verticalement, mais pas horizontalement.
RESIZE_HORIZ Le contrôle Tab peut être redimensionné horizontalement, mais pas verticalement.

CMFCTabCtrl::SetTabMaxWidth

Spécifie la largeur maximale de tabulation dans une fenêtre à onglets.

void SetTabMaxWidth(int nTabMaxWidth);

Paramètres

nTabMaxWidth
[in] Largeur maximale des onglets, en pixels.

Notes

Utilisez cette méthode pour limiter la largeur de chaque onglet dans une fenêtre à onglets. Cette méthode est utile si les onglets ont des étiquettes très longues. Le CMFCTabCtrl constructeur de classe initialise la largeur maximale de tabulation à 0, ce qui signifie en fait que la largeur n’est pas limitée.

CMFCTabCtrl::StopResize

Met fin à l’opération de redimensionnement actuelle sur le contrôle Tab.

void StopResize(BOOL bCancel);

Paramètres

bCancel
[in] TRUE pour abandonner l’opération de redimensionnement actuelle ; FALSE pour terminer l’opération de redimensionnement actuelle. Dans les deux cas, l’infrastructure arrête de dessiner le rectangle de redimensionnement.

CMFCTabCtrl::SynchronizeScrollBar

Dessine une barre de défilement horizontale sur un contrôle tabulation qui affiche des onglets plats.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Paramètres

pScrollInfo
[out] Pointeur vers une SCROLLINFO structure ou NULL. Lorsque cette méthode est retournée, et si ce paramètre n’est pas NULLle cas, la structure contient tous les paramètres de la barre de défilement. La valeur par défaut est NULL.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE.

Notes

Cette méthode affecte uniquement un contrôle tabulation qui affiche des onglets plats. La barre de défilement influence tous les onglets en même temps.

Voir aussi

Graphique hiérarchique
Classes
CDockablePane Classe
CMFCBaseTabCtrl Classe