CMDITabInfo, classe
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
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