Classe de CMFCBaseTabCtrl

Article
03/12/2013

Implémente les fonctionnalités de base des fenêtres à onglet.

class CMFCBaseTabCtrl : public CWnd

Membres

Méthodes publiques

Nom	Description
CMFCBaseTabCtrl::AddIcon
CMFCBaseTabCtrl::AddTab	Ajoute un nouvel onglet de la fenêtre à onglet.
CMFCBaseTabCtrl::ApplyRestoredTabInfo
CMFCBaseTabCtrl::AutoDestroyWindow
CMFCBaseTabCtrl::CalcRectEdit
CMFCBaseTabCtrl::CleanUp
CMFCBaseTabCtrl::ClearImageList
CMFCBaseTabCtrl::DetachTab	Détache un onglet d'une fenêtre avec onglets.
CMFCBaseTabCtrl::EnableActivateLastActive
CMFCBaseTabCtrl::EnableAutoColor	Active ou désactive la coloration automatique d'onglet.
CMFCBaseTabCtrl::EnableCustomToolTips	Active ou désactive les info-bulles personnalisées pour les onglets.
CMFCBaseTabCtrl::EnableInPlaceEdit	Active ou désactive les dirigent la modification des étiquettes d'onglet.
CMFCBaseTabCtrl::EnableTabDetach	Active les onglets détachables.
CMFCBaseTabCtrl::EnableTabSwap	Active ou désactive si l'utilisateur peut modifier l'ordre de tabulation à l'aide de la souris.
CMFCBaseTabCtrl::EnsureVisible	Fait défiler les onglets jusqu'à ce que l'onglet spécifié soit visible.Cette méthode n'a aucun effet si l'onglet spécifié est déjà visible.
CMFCBaseTabCtrl::EnterDragMode
CMFCBaseTabCtrl::FindTargetWnd	Retourne un volet qui contient un point spécifié.
CMFCBaseTabCtrl::FireChangeActiveTab
CMFCBaseTabCtrl::FireChangingActiveTab
CMFCBaseTabCtrl::GetActiveTab	Retourne l'index de l'onglet actif.
CMFCBaseTabCtrl::GetActiveTabColor	Retourne la couleur d'arrière-plan de la table active.
CMFCBaseTabCtrl::GetActiveTabTextColor	Retourne la couleur de texte de l'onglet actif.
CMFCBaseTabCtrl::GetActiveWnd	Retourne un pointeur la page active du contrôle onglet.
CMFCBaseTabCtrl::GetAutoColors	Retourne une référence au choix de couleurs utilisées pour la coloration automatique.
CMFCBaseTabCtrl::GetFirstVisibleTab	Retourne un pointeur vers la première table visible.
CMFCBaseTabCtrl::GetFirstVisibleTabNum
CMFCBaseTabCtrl::GetHighlightedTab	Retourne l'index de l'onglet actuel en surbrillance.
CMFCBaseTabCtrl::GetImageList
CMFCBaseTabCtrl::GetImageSize
CMFCBaseTabCtrl::GetLastVisibleTab
CMFCBaseTabCtrl::GetLocation	Retourne une variable du type de données d'EMPLACEMENT qui indique où la zone d'onglet est positionnée par rapport à le contrôle onglet.Par exemple, en haut ou en bas.
CMFCBaseTabCtrl::GetMaxWindowSize
CMFCBaseTabCtrl::GetTabArea	Retourne la taille et la position de la zone de l'onglet de la fenêtre vers onglet.La position de la zone d'onglet est définie à l'aide de les coordonnées.
CMFCBaseTabCtrl::GetTabBkColor	Retourne la couleur d'arrière-plan de la table spécifiée.
CMFCBaseTabCtrl::GetTabBorderSize	Retourne la taille des zones d'onglet dans le contrôle onglet.
CMFCBaseTabCtrl::GetTabByID	Retourne l'index de l'onglet identifié par un ID spécifiée
CMFCBaseTabCtrl::GetTabCloseButton
CMFCBaseTabCtrl::GetTabFromHwnd	Retourne l'index d'un onglet qui contient un objet spécifié HWND.
CMFCBaseTabCtrl::GetTabFromPoint	Retourne l'onglet qui contient un point spécifié.
CMFCBaseTabCtrl::GetTabFullWidth
CMFCBaseTabCtrl::GetTabHicon	Retourne l'icône associée à la table spécifiée.
CMFCBaseTabCtrl::GetTabID	Retourne l'ID d'un onglet à l'aide de l'index de la table.
CMFCBaseTabCtrl::GetTabIcon	Retourne l'ID d'icône pour une table spécifiée.
CMFCBaseTabCtrl::GetTabLabel	Retourne le texte d'une table spécifiée.
CMFCBaseTabCtrl::GetTabRect	Extrait la taille et la position d'une table spécifiée.
CMFCBaseTabCtrl::GetTabsHeight
CMFCBaseTabCtrl::GetTabsRect
CMFCBaseTabCtrl::GetTabTextColor	Retourne la couleur du texte d'une table spécifiée.
CMFCBaseTabCtrl::GetTabWnd	Retourne le pointeur à un volet qui réside dans une page d'onglets spécifiée.
CMFCBaseTabCtrl::GetTabWndNoWrapper	Retourne le pointeur direct à un contrôle qui réside dans une page d'onglets spécifiée, même si le contrôle a un wrapper.
CMFCBaseTabCtrl::GetTabsNum	Retourne le nombre d'onglets qui sont contenus dans le contrôle onglet.
CMFCBaseTabCtrl::GetToolTipCtrl	Retourne une référence au contrôle d'info-bulle associées à l'objet d' CMFCBaseTabCtrl .
CMFCBaseTabCtrl::GetVisibleTabsNum	Retourne le nombre d'onglets visibles.
CMFCBaseTabCtrl::HasImage
CMFCBaseTabCtrl::HideSingleTab	Définit une option qui masque un onglet de la fenêtre, mais uniquement si la fenêtre à un onglet affiche une table visible uniquement.
CMFCBaseTabCtrl::InsertTab	Insère une nouvelle table.
CMFCBaseTabCtrl::InvalidateTab
CMFCBaseTabCtrl::IsActiveTabCloseButton
CMFCBaseTabCtrl::IsAutoColor	Retourne une valeur qui indique si une fenêtre avec onglets est en mode d'automatique- couleur.
CMFCBaseTabCtrl::IsAutoDestroyWindow
CMFCBaseTabCtrl::IsColored
CMFCBaseTabCtrl::IsDialogControl
CMFCBaseTabCtrl::IsDrawNoPrefix
CMFCBaseTabCtrl::IsFlatFrame	Retourne une valeur qui indique si le frame pour la zone d'onglet est stable ou 3D.
CMFCBaseTabCtrl::IsFlatTab
CMFCBaseTabCtrl::IsHideSingleTab	Retourne une valeur qui indique si le contrôle onglet est configuré pour masquer un onglet, mais uniquement si une fenêtre avec onglets a qu'une table visible.
CMFCBaseTabCtrl::IsIconAdded
CMFCBaseTabCtrl::IsInPlaceEdit	Indique si les utilisateurs peuvent modifier l'étiquette sous un onglet.
CMFCBaseTabCtrl::IsLeftRightRounded
CMFCBaseTabCtrl::IsMDITab
CMFCBaseTabCtrl::IsOneNoteStyle	Indique si une fenêtre avec onglet affiche des onglets dans le style OneNote Microsoft.
CMFCBaseTabCtrl::IsPtInTabArea	Vérifie si un point spécifié existe dans la zone de l'onglet.
CMFCBaseTabCtrl::IsTabCloseButtonHighlighted
CMFCBaseTabCtrl::IsTabCloseButtonPressed
CMFCBaseTabCtrl::IsTabDetachable	Indique si un onglet est détachable.
CMFCBaseTabCtrl::IsTabIconOnly	Indique si les icônes mais pas les étiquettes d'affichage d'onglets.
CMFCBaseTabCtrl::IsTabSwapEnabled	Indique si l'utilisateur peut modifier les positions de tabulation en faisant glisser des onglets.
CMFCBaseTabCtrl::IsTabVisible	Indique si un onglet spécifié est visible.
CMFCBaseTabCtrl::IsVS2005Style
CMFCBaseTabCtrl::MoveTab
CMFCBaseTabCtrl::OnChangeTabs	Appelé par l'infrastructure lorsque le nombre d'onglets change.
CMFCBaseTabCtrl::OnDragEnter
CMFCBaseTabCtrl::OnDragLeave
CMFCBaseTabCtrl::OnDragOver
CMFCBaseTabCtrl::OnDrop
CMFCBaseTabCtrl::OnRenameTab
CMFCBaseTabCtrl::PreTranslateMessage	Utilisé par la classe CWinApp pour convertir des messages de fenêtre pour qu'ils soient distribués aux fonctions Windows de TranslateMessage et de DispatchMessage .(Substitutions CWnd::PreTranslateMessage.)
CMFCBaseTabCtrl::RecalcLayout	Recalcule la disposition interne d'une fenêtre avec onglets.
CMFCBaseTabCtrl::RemoveAllTabs	Supprime tous les onglets de la fenêtre vers onglet.
CMFCBaseTabCtrl::RemoveTab	Supprime un onglet d'une fenêtre avec onglets.
CMFCBaseTabCtrl::RenameTab
CMFCBaseTabCtrl::ResetImageList	Réinitialise la liste d'images qui est attachée à une fenêtre avec onglets.
CMFCBaseTabCtrl::Serialize	Lit ou écrit cet objet ou y retourne une archive.(Substitutions CObject::Serialize.)
CMFCBaseTabCtrl::SetActiveTab	Lance une table.
CMFCBaseTabCtrl::SetActiveTabColor	Définit la couleur d'arrière-plan pour actuel - l'onglet actif.
CMFCBaseTabCtrl::SetActiveTabTextColor	Définit la couleur de texte pour les onglets actifs.
CMFCBaseTabCtrl::SetAutoColors	Définit les couleurs de contrôle onglet qui sont appliquées en mode automatique de couleur.
CMFCBaseTabCtrl::SetDockingBarWrapperRTC	Définit la classe wrapper qui est utilisée pour tous les objets qui ne sont pas dérivés de Classe de CDockablePane.
CMFCBaseTabCtrl::SetDrawNoPrefix	Active et désactive le traitement des caractères de préfixe lorsque les étiquettes d'onglet sont dessinées.
CMFCBaseTabCtrl::SetImageList	Définit la liste d'images d'icône.
CMFCBaseTabCtrl::SetLocation
CMFCBaseTabCtrl::SetTabBkColor	Définit la couleur d'arrière-plan pour une table spécifiée.
CMFCBaseTabCtrl::SetTabBorderSize	Définit une nouvelle taille de la bordure de tabulation.
CMFCBaseTabCtrl::SetTabHicon	Définit une icône d'onglet.
CMFCBaseTabCtrl::SetTabIcon	Définit un ID d'icône d'onglet
CMFCBaseTabCtrl::SetTabIconOnly	Active et désactive l'état « icône que » pour une table spécifiée.
CMFCBaseTabCtrl::SetTabLabel	Définit une étiquette d'onglet égale à une valeur de chaîne spécifiée.
CMFCBaseTabCtrl::SetTabsHeight
CMFCBaseTabCtrl::SetTabTextColor	Définit la couleur de texte pour une table spécifiée.
CMFCBaseTabCtrl::SetTabsOrder	Réorganise des onglets dans l'ordre spécifié.
CMFCBaseTabCtrl::ShowTab	Affiche ou masque la table spécifiée.
CMFCBaseTabCtrl::StartRenameTab
CMFCBaseTabCtrl::SwapTabs

Méthodes protégées

Nom	Description
CMFCBaseTabCtrl::CreateWrapper	Crée un wrapper pour un objet dérivé de CWnd qui n'est pas dérivé d' CDockablePane.Pour ancrer un objet d' CMFCBaseTabCtrl , chaque contrôle inclus doit avoir un wrapper d'ancrage ou être dérivé d' CDockablePane. Vous avez défini la classe de wrapper à l'aide de SetDockingBayWrapperRTC.

CMFCBaseTabCtrl::CreateWrapper

Crée un wrapper pour un objet dérivé de CWnd qui n'est pas dérivé d' CDockablePane.Pour ancrer un objet d' CMFCBaseTabCtrl , chaque contrôle inclus doit avoir un wrapper d'ancrage ou être dérivé d' CDockablePane.

Vous avez défini la classe de wrapper à l'aide de SetDockingBayWrapperRTC.

Membres de données

Nom	Description
CMFCBaseTabCtrl::m_bActivateTabOnRightClick	Spécifie si les onglets sont sélectionnés à l'aide d'un clic de souris gauche ou d'un bon clic de souris.
CMFCBaseTabCtrl::m_bAutoDestroyWindow	Spécifie si les volets qui sont contenus dans les onglets sont détruits automatiquement.

Notes

La classe CMFCBaseTabCtrl est une classe abstraite.Par conséquent, il ne peut pas être instancié.Pour créer une fenêtre avec onglets, vous devez dériver une classe d' CMFCBaseTabCtrl.La bibliothèque MFC contient quelques exemples classe dérivée, dont deux sont Classe de CMFCTabCtrl et Classe de CMFCOutlookBarTabCtrl.

Conseils de personnalisation

Les conseils suivants se rapportent Classe de CMFCBaseTabCtrl et les classes qui héritent de celui-ci :

Si vous activez les onglets détachables, ne conservez pas les pointeurs aux fenêtres à onglet.Ces onglets détachables peuvent être créés et détruits dynamiquement.Par conséquent, les pointeurs peuvent devenir non valides.
Vous pouvez configurer le contrôle onglet afin que les utilisateurs puissent se déplacer des onglets dynamiquement sur un contrôle onglet à l'aide de la souris.Cette fonctionnalité est intégrée dans la classe d' CMFCBaseTabCtrl .Pour l'activer, appelez CMFCBaseTabCtrl::EnableTabSwap.
Par défaut, les onglets sont détachables lorsque vous les ajoutez à un contrôle onglet.Vous pouvez également ajouter des onglets non détachables à l'aide de CMFCBaseTabCtrl::AddTab.Si vous affectez au paramètre bDetachable à FALSE, l'onglet ne sera pas détachable.Vous pouvez également modifier si les onglets sont détachables en appelant la méthode CMFCBaseTabCtrl::EnableTabDetach.
Les objets dérivés de CWnd, classe peuvent être mis sur une barre de contrôles ancrable ou une table ancrable.Pour que le contrôle entière est ancré, vous devez rendre l'objet d' CWnd ancrable.Pour ce faire, MFC utilise une classe wrapper.Cette classe wrapper est Classe de CDockablePaneAdapter.Tous les objets d' CWnd ajoutés à une barre de contrôles ancrable ou à un onglet ancrable sont encapsulés dans un objet d' CDockablePaneAdapter .Vous pouvez désactiver l'encapsulation automatique en affectant au paramètre m_bEnableWrapping de votre objet d' CMFCBaseTablCtrl à FALSE.Vous pouvez également modifier la classe que votre application utilisera comme wrapper à l'aide de la méthode CMFCBaseTabCtrl::SetDockingBarWrapperRTC.