Partager via

CMDITabInfo, classe

  • Article

La CMDITabInfo classe est utilisée pour passer des paramètres à la méthode CMDIFrameWndEx ::EnableMDITabbedGroups . Définissez les membres de cette classe de manière à contrôler le comportement des groupes avec onglet MDI.

Syntaxe

class CMDITabInfo

Membres

Constructeurs publics

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

Méthodes publiques

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

Données membres

Nom Description
CMDITabInfo ::m_bActiveTabCloseButton ; Spécifie si un bouton Fermer s’affiche sur l’étiquette de l’onglet actif.
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 Spécifie si chaque étiquette d’onglet affiche un bouton Fermer .
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.

Notes

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

Exemple

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

Hiérarchie d'héritage

CMDITabInfo

Spécifications

En-tête : afxmdiclientareawnd.h

CMDITabInfo ::m_bActiveTabCloseButton ;

Spécifie si un bouton Fermer s’affiche sur l’étiquette de l’onglet actif.

BOOL m_bActiveTabCloseButton;

Notes

Si la valeur est TRUE, l’étiquette de l’onglet actif affiche un bouton Fermer . Le bouton Fermer est supprimé du coin supérieur droit de la zone d’onglet. Sinon, l’étiquette de l’onglet actif n’affiche pas de bouton Fermer . Le bouton Fermer s’affiche dans le coin supérieur droit de la zone d’onglet.

CMDITabInfo ::m_bAutoColor

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

BOOL m_bAutoColor;

Notes

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;

Notes

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;

Notes

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

Spécifie si chaque fenêtre d’onglet affiche un bouton Fermer .

BOOL m_bTabCloseButton;

Notes

Si la valeur est TRUE, chaque fenêtre d’onglet affiche le bouton Fermer sur le bord droit de l’onglet. Sinon, le bouton Fermer n’est pas affiché. La valeur par défaut est TRUE.

CMDITabInfo ::m_bTabCustomTooltips

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

BOOL m_bTabCustomTooltips;

Notes

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;

Notes

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;

Notes

CMFCVisualManager ::GetMDITabsBordersSize retourne la valeur par défaut.

CMDITabInfo ::m_style

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

CMFCTabCtrl::Style m_style

Notes

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

Macro Description
STYLE_3D Style 3D.
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;

Notes

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

Paramètres

Ar
[in] Objet CArchive Class à sérialiser.

Voir aussi

CMDIFrameWndEx, classe
Groupes avec onglet MDI
Graphique hiérarchique
Classes