Partager via


CMDITabInfo Class

The CMDITabInfo class is used to pass parameters to CMDIFrameWndEx::EnableMDITabbedGroups method. Définissez les membres de cette classe de manière à contrôler le comportement des groupes avec onglet MDI.

Syntax

class CMDITabInfo

Members

Public Constructors

Name Description
CMDITabInfo::CMDITabInfo Default constructor.

Public Methods

Name Description
CMDITabInfo::Serialize Lit ou écrit cet objet dans une archive.

Data Members

Name Description
CMDITabInfo::m_bActiveTabCloseButton; Specifies whether a Close button is displayed on the label of the active tab.
CMDITabInfo::m_bAutoColor Spécifie s’il faut colorer les onglets MDI.
CMDITabInfo::m_bDocumentMenu Spécifie si le groupe d’onglets affiche un menu contextuel qui affiche une liste de documents ouverts ou affiche des boutons de défilement.
CMDITabInfo::m_bEnableTabSwap Spécifie si l’utilisateur peut permuter les positions des onglets en faisant glisser.
CMDITabInfo::m_bFlatFrame Spécifie si les onglets ont un cadre plat.
CMDITabInfo::m_bTabCloseButton Specifies whether each tab label displays a Close button.
CMDITabInfo::m_bTabCustomTooltips Spécifie si les info-bulles personnalisées sont activées.
CMDITabInfo::m_bTabIcons Spécifie s’il faut afficher des icônes sous les onglets MDI.
CMDITabInfo::m_nTabBorderSize Spécifie la taille de bordure de chaque fenêtre d’onglet.
CMDITabInfo::m_style Spécifie le style des étiquettes d’onglet.
CMDITabInfo::m_tabLocation Spécifie si les étiquettes des onglets se trouvent en haut ou en bas de la page.

Remarks

Cette classe spécifie les paramètres des groupes d’onglets MDI créés par l’infrastructure.

Example

L’exemple suivant montre comment définir les valeurs des différentes variables membres dans CMDITabInfo la classe.

CMDITabInfo mdiTabParams;
mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_ONENOTE;
// set to FALSE to place close button at right of tab area
mdiTabParams.m_bActiveTabCloseButton = FALSE;
// set to TRUE to enable document icons on MDI taba
mdiTabParams.m_bTabIcons = TRUE;
// set to FALSE to disable auto-coloring of MDI tabs
mdiTabParams.m_bAutoColor = FALSE;
// set to TRUE to enable the document menu at the right edge of the tab area
mdiTabParams.m_bDocumentMenu = TRUE;
//set to TRUE to enable the user to change the tabs positions by dragging the tabs
mdiTabParams.m_bEnableTabSwap = TRUE;
// set to TRUE to give each tab window has a flat frame
mdiTabParams.m_bFlatFrame = TRUE;
// set to TRUE to enable each tab window to display the Close button on the right edge of the tab.
mdiTabParams.m_bTabCloseButton = FALSE;
// set to TRUE to enable the tabs to display tooltips.
mdiTabParams.m_bTabCustomTooltips = TRUE;
// Specifies that the tabs labels are located at the top of the page
mdiTabParams.m_tabLocation = CMFCTabCtrl::LOCATION_TOP;
EnableMDITabbedGroups(TRUE, mdiTabParams);

Inheritance Hierarchy

CMDITabInfo

Requirements

Header: afxmdiclientareawnd.h

CMDITabInfo::m_bActiveTabCloseButton

Specifies whether a Close button is displayed on the label of the active tab.

BOOL m_bActiveTabCloseButton;

Remarks

If TRUE, the label of the active tab will display a Close button. The Close button will be removed from the right top corner of the tab area. Otherwise, the label of the active tab will not display a Close button. The Close button will appear in the right top corner of the tab area.

CMDITabInfo::m_bAutoColor

Spécifie si chaque onglet MDI a sa propre couleur.

BOOL m_bAutoColor;

Remarks

Si la valeur est TRUE, chaque onglet aura sa propre couleur. L’ensemble de couleurs est géré par la bibliothèque MFC. Sinon, les onglets sont affichés en blanc. La valeur par défaut est FALSE.

CMDITabInfo::m_bDocumentMenu

Spécifie si chaque onglet affiche un menu contextuel qui affiche une liste de documents ouverts au bord droit de la zone d’onglet.

BOOL m_bDocumentMenu;

Remarks

Si la valeur est TRUE, chaque fenêtre d’onglet affiche un menu contextuel qui affiche une liste de documents ouverts au bord droit de la zone d’onglet ; Sinon, la fenêtre d’onglet affiche les boutons de défilement au bord droit de la zone d’onglet. La valeur par défaut est FALSE.

CMDITabInfo::m_bEnableTabSwap

Spécifie si l’utilisateur peut permuter les positions des onglets en faisant glisser.

BOOL m_bEnableTabSwap;

Remarks

Si la valeur est TRUE, l’utilisateur peut modifier les positions des onglets en faisant glisser les onglets. Sinon, l’utilisateur ne peut pas modifier les positions des onglets. La valeur par défaut est TRUE.

CMDITabInfo::m_bFlatFrame

Spécifie si chaque fenêtre d’onglet a un cadre plat.

BOOL m_bFlatFrame;

CMDITabInfo::m_bTabCloseButton

Specifies whether each tab window displays a Close button.

BOOL m_bTabCloseButton;

Remarks

If TRUE, each tab window displays the Close button on the right edge of the tab. Otherwise, the Close button is not displayed. La valeur par défaut est TRUE.

CMDITabInfo::m_bTabCustomTooltips

Spécifie si les onglets affichent des info-bulles.

BOOL m_bTabCustomTooltips;

Remarks

Si la valeur est TRUE, l’application envoie un message AFX_WM_ON_GET_TAB_TOOLTIP au cadre principal. Vous pouvez gérer ce message à l’aide de la macro ON_REGISTERED_MESSAGE.

CMDITabInfo::m_bTabIcons

Spécifie s’il faut afficher des icônes sous les onglets MDI.

BOOL m_bTabIcons;

Remarks

Si la valeur est TRUE, les icônes sont affichées sous chaque onglet MDI. Sinon, les icônes ne sont pas affichées sur les onglets. La valeur par défaut est FALSE.

CMDITabInfo::m_nTabBorderSize

Spécifie la taille de bordure, en pixels, de chaque fenêtre d’onglet.

int m_nTabBorderSize;

Remarks

CMFCVisualManager::GetMDITabsBordersSize returns the default value.

CMDITabInfo::m_style

Spécifie le style des étiquettes d’onglet.

CMFCTabCtrl::Style m_style

Remarks

Spécifiez l’un des styles suivants pour les étiquettes d’onglet :

Macro Description
STYLE_3D 3D style.
STYLE_3D_ONENOTE Style Microsoft OneNote.
STYLE_3D_VS2005 Style Microsoft Visual Studio 2005.
STYLE_3D_SCROLLED Style 3D avec des étiquettes d’onglet rectangle.
STYLE_FLAT_SHARED_HORZ_SCROLL Style plat avec barre de défilement horizontale partagée.
STYLE_3D_ROUNDED_SCROLL Style 3D avec des étiquettes d’onglet arrondi.

CMDITabInfo::m_tabLocation

Spécifie si les étiquettes des onglets se trouvent en haut ou en bas de la page.

CMFCTabCtrl::Location m_tabLocation;

Remarks

Appliquez aux onglets l’un des indicateurs d’emplacement suivants :

  • LOCATION_BOTTOM : les étiquettes d’onglets se trouvent en bas de la page.

  • LOCATION_TOP : les étiquettes d’onglets se trouvent en haut de la page

CMDITabInfo::Serialize

Lit ou écrit cet objet à partir d’une archive ou dans une archive.

void Serialize(CArchive& ar);

Parameters

ar
[in] A CArchive Class object to serialize.

See also

CMDIFrameWndEx Class
Groupes avec onglet MDI
Hierarchy Chart
Classes