CMFCOutlookBarTabCtrl, classe
Contrôle onglet qui a l'apparence visuelle du Volet de navigation dans Microsoft Outlook. Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.
Syntaxe
class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl
Membres
Constructeurs publics
| Nom | Description |
|---|---|
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl |
Constructeur par défaut. |
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl |
Destructeur. |
Méthodes publiques
| Nom | Description |
|---|---|
| CMFCOutlookBarTabCtrl ::AddControl | Ajoute un contrôle Windows sous la forme d’un nouvel onglet dans la barre Outlook. |
CMFCOutlookBarTabCtrl::CalcRectEdit |
Appelé par l’infrastructure pour déterminer les dimensions de la zone d’édition qui s’affiche lorsqu’un utilisateur renomme un onglet. (Remplace CMFCBaseTabCtrl::CalcRectEdit.) |
| CMFCOutlookBarTabCtrl ::CanShowFewerPageButtons | Appelé par l’infrastructure pendant les opérations de redimensionnement pour déterminer si moins de boutons de page d’onglets de barre Outlook peuvent être affichés que ceux actuellement visibles. |
| CMFCOutlookBarTabCtrl ::CanShowMorePageButtons | Appelé par l’infrastructure pendant les opérations de redimensionnement pour déterminer si plus de boutons de page d’onglets de barre Outlook peuvent être affichés que ceux actuellement visibles. |
| CMFCOutlookBarTabCtrl ::Create | Crée le contrôle d’onglet de barre Outlook. |
CMFCOutlookBarTabCtrl::CreateObject |
Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe. |
| CMFCOutlookBarTabCtrl ::EnableAnimation | Spécifie si l’animation qui se produit pendant le commutateur entre les onglets actifs est activée. |
| CMFCOutlookBarTabCtrl ::EnableInPlaceEdit | Spécifie si un utilisateur peut modifier les étiquettes de texte sur les boutons d’onglet de la barre Outlook. (Remplacements CMFCBaseTabCtrl ::EnableInPlaceEdit.) |
| CMFCOutlookBarTabCtrl ::EnableScrollButtons | Appelé par l’infrastructure pour activer les boutons qui permettent à l’utilisateur de faire défiler les boutons dans le volet de la barre Outlook. |
CMFCOutlookBarTabCtrl::FindTargetWnd |
Identifie le volet qui contient un point spécifié. (Remplacements CMFCBaseTabCtrl ::FindTargetWnd.) |
| CMFCOutlookBarTabCtrl ::GetBorderSize | Retourne la taille de bordure du contrôle d’onglet Outlook. |
CMFCOutlookBarTabCtrl::GetTabArea |
Récupère la taille et la position de la zone de tabulation du contrôle Tab. (Remplacements CMFCBaseTabCtrl ::GetTabArea.) |
CMFCOutlookBarTabCtrl::GetThisClass |
Utilisé par l’infrastructure pour obtenir un pointeur vers l’objet CRuntimeClass associé à ce type de classe. |
| CMFCOutlookBarTabCtrl ::GetVisiblePageButtons | |
| CMFCOutlookBarTabCtrl ::IsAnimation | Détermine si l’animation qui se produit pendant le basculement entre les onglets actifs est activée. |
| CMFCOutlookBarTabCtrl ::IsMode2003 | Détermine si le contrôle d’onglet de barre Outlook est en mode émulant Microsoft Outlook 2003. |
CMFCOutlookBarTabCtrl::IsPtInTabArea |
Détermine si un point se trouve à l’intérieur de la zone d’onglet. (Remplacements CMFCBaseTabCtrl ::IsPtInTabArea.) |
CMFCOutlookBarTabCtrl::IsTabDetachable |
Détermine si un onglet est détachable. (Remplacements CMFCBaseTabCtrl ::IsTabDetachable.) |
CMFCOutlookBarTabCtrl::OnChangeTabs |
Appelé par l’infrastructure lorsqu’un onglet est inséré ou supprimé. (Substitue CMFCBaseTabCtrl::OnChangeTabs.) |
| CMFCOutlookBarTabCtrl ::OnShowFewerPageButtons | Appelé par l’infrastructure pour réduire le nombre de boutons de page d’onglets visibles. |
| CMFCOutlookBarTabCtrl ::OnShowMorePageButtons | Appelé par l’infrastructure pour augmenter le nombre de boutons de page d’onglets visibles. |
| CMFCOutlookBarTabCtrl ::OnShowOptions | Affiche la boîte de dialogue Options du volet de navigation. |
CMFCOutlookBarTabCtrl::RecalcLayout |
Recalcule la disposition interne du contrôle Tab. (Remplacements CMFCBaseTabCtrl ::RecalcLayout.) |
| CMFCOutlookBarTabCtrl ::SetActiveTab | Définit l’onglet actif. (Remplace CMFCBaseTabCtrl ::SetActiveTab.) |
| CMFCOutlookBarTabCtrl ::SetBorderSize | Définit la taille de bordure du contrôle d’onglet Outlook. |
| CMFCOutlookBarTabCtrl ::SetPageButtonTextAlign | Définit l’alignement des étiquettes de texte sur les boutons d’onglet de la barre Outlook. |
| CMFCOutlookBarTabCtrl ::SetToolbarImageList | Définit la bitmap qui contient les icônes affichées en bas de la barre Outlook en mode Outlook 2003 (voir CMFCOutlookBar, classe). |
| CMFCOutlookBarTabCtrl ::SetVisiblePageButtons |
Notes
Pour créer une barre Outlook qui prend en charge l’ancrage, utilisez un CMFCOutlookBar objet pour héberger le contrôle d’onglet de barre Outlook. Pour plus d’informations, consultez CMFCOutlookBar, classe.
Exemple
L’exemple suivant montre comment initialiser un CMFCOutlookBarTabCtrl objet et utiliser différentes méthodes dans la CMFCOutlookBarTabCtrl classe. L’exemple montre comment activer la modification sur place de l’étiquette de texte sur les boutons de page onglet de la barre Outlook, activer l’animation, activer les poignées de défilement qui permettent à l’utilisateur de faire défiler les boutons dans le volet de barre Outlook, de définir la taille de bordure du contrôle Onglet Outlook et de définir l’alignement des étiquettes de texte sur les boutons onglets de la barre Outlook. Cet extrait de code fait partie de l’exemple de démonstration Outlook.
// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();
pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);
Hiérarchie d'héritage
Spécifications
En-tête : afxoutlookbartabctrl.h
CMFCOutlookBarTabCtrl ::AddControl
Ajoute un contrôle Windows sous la forme d’un nouvel onglet dans la barre Outlook.
void AddControl(
CWnd* pWndCtrl,
LPCTSTR lpszName,
int nImageID=-1,
BOOL bDetachable=TRUE,
DWORD dwControlBarStyle=AFX_CBRS_FLOAT | AFX_CBRS_CLOSE | AFX_CBRS_RESIZE | CBRS_AFX_AUTOHIDE);
Paramètres
pWndCtrl
[in] Pointeur vers un contrôle à ajouter.
lpszName
[in] Spécifie le nom de l’onglet.
bDetachable
[in] Si la valeur est TRUE, la page est créée comme détachable.
nImageID
[in] Index d’image dans la liste d’images interne de l’image à afficher dans le nouvel onglet.
dwControlBarStyle
[in] Spécifie le style AFX_ CBRS_* pour les volets d’ancrage encapsulés.
Notes
Utilisez cette fonction pour ajouter un contrôle en tant que nouvelle page d’une barre Outlook.
Cette fonction appelle en interne CMFCBaseTabCtrl ::AddTab.
Si vous définissez bDetachable sur TRUE, AddControl crée en interne un CDockablePaneAdapter objet et encapsule le contrôle ajouté. Elle définit automatiquement la classe runtime de la fenêtre tabulée sur la classe runtime et CMFCOutlookBar la classe runtime du frame CMultiPaneFrameWndflottant sur .
Exemple
L’exemple suivant montre comment utiliser la AddControl méthode dans la CMFCOutlookBarTabCtrl classe. Cet extrait de code fait partie de l’exemple de démonstration Outlook.
// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);
CMFCOutlookBarTabCtrl ::CanShowFewerPageButtons
Appelé par l’infrastructure pendant les opérations de redimensionnement pour déterminer si moins de boutons de page d’onglets de barre Outlook peuvent être affichés que ceux actuellement visibles.
virtual BOOL CanShowFewerPageButtons() const;
Valeur de retour
TRUE s’il existe plusieurs boutons ; sinon FALSE.
Notes
Le contrôle d’onglet de barre Outlook ajoute ou supprime dynamiquement des onglets de l’affichage en fonction de la quantité d’espace disponible. Cette méthode est utilisée par l’infrastructure pour faciliter ce processus.
CMFCOutlookBarTabCtrl ::CanShowMorePageButtons
Appelé par l’infrastructure pendant les opérations de redimensionnement pour déterminer si davantage de boutons de page d’onglets de barre Outlook peuvent être affichés que ceux actuellement visibles.
virtual BOOL CanShowMorePageButtons() const;
Valeur de retour
TRUE s’il existe des boutons qui ne sont actuellement pas visibles ; sinon FALSE.
Notes
Le contrôle d’onglet de barre Outlook ajoute ou supprime dynamiquement des onglets de l’affichage, en fonction de la quantité de salle disponible. Cette méthode est utilisée par l’infrastructure pour faciliter ce processus.
CMFCOutlookBarTabCtrl ::Create
Crée le contrôle d’onglet de barre Outlook.
virtual BOOL Create(
const CRect& rect,
CWnd* pParentWnd,
UINT nID);
Paramètres
Rect
[in] Spécifie la taille et la position initiales, en pixels.
pParentWnd
[in] Pointe vers la fenêtre parente. Ne doit pas avoir la valeur Null.
nID
[in] ID de contrôle.
Valeur de retour
Différent de zéro si le contrôle a été créé avec succès ; sinon 0.
Notes
En règle générale, les contrôles d’onglet de barre Outlook sont créés lorsque la classe CMFCOutlookBar contrôle le message WM_CREATE du processus.
CMFCOutlookBarTabCtrl ::EnableAnimation
Spécifie si l’animation qui se produit pendant le commutateur entre les onglets actifs est activée.
static void EnableAnimation(BOOL bEnable=TRUE);
Paramètres
bEnable
[in] Spécifie si l’animation doit être activée ou désactivée.
Notes
Appelez cette fonction pour activer et désactiver l’animation. Lorsque l’utilisateur ouvre une page d’onglets, la légende diapositives vers le haut ou vers le bas si l’animation est activée. Si l’animation est désactivée, la page devient active immédiatement.
Par défaut, l’animation est activée.
CMFCOutlookBarTabCtrl ::EnableInPlaceEdit
Spécifie si un utilisateur peut modifier les étiquettes de texte sur les boutons de la page onglet de la barre Outlook.
virtual void EnableInPlaceEdit(BOOL bEnable);
Paramètres
bEnable
Si la valeur est TRUE, activez la modification sur place de l’étiquette de texte. Si la valeur est FALSE, désactivez la modification sur place.
Notes
Appelez cette fonction pour activer ou désactiver la modification sur place des étiquettes de texte sur les boutons de page onglet. Par défaut, la modification sur place est désactivée.
CMFCOutlookBarTabCtrl ::EnableScrollButtons
Appelé par l’infrastructure pour activer les poignées de défilement qui permettent à l’utilisateur de faire défiler les boutons dans le volet de barre Outlook.
void EnableScrollButtons(
BOOL bEnable = TRUE,
BOOL bIsUp = TRUE,
BOOL bIsDown = TRUE);
Paramètres
bEnable
[in] Détermine si les boutons de défilement sont affichés.
bIsUp
[in] Détermine si la barre de défilement supérieure est affichée.
bIsDown
[in] Détermine si la barre de défilement inférieure est affichée.
Notes
Active l’affichage des boutons de défilement. Cette méthode est appelée par l’infrastructure lorsque l’onglet actif change pour restaurer les boutons de défilement.
CMFCOutlookBarTabCtrl ::GetBorderSize
Retourne la taille de bordure du contrôle d’onglet Outlook.
int GetBorderSize() const;
Valeur de retour
Taille de la bordure, en pixels.
CMFCOutlookBarTabCtrl ::GetVisiblePageButtons
int GetVisiblePageButtons() const;
Valeur de retour
Notes
CMFCOutlookBarTabCtrl ::IsAnimation
Spécifie si l’animation qui se produit pendant le commutateur entre les onglets actifs est activée.
static BOOL IsAnimation();
Valeur de retour
Différent de zéro si l’animation est activée ; sinon 0.
Notes
Appelez la fonction CMFCOutlookBarTabCtrl ::EnableAnimation pour activer ou désactiver l’animation.
CMFCOutlookBarTabCtrl ::IsMode2003
Détermine si le contrôle d’onglet de barre Outlook est en mode émulant Microsoft Outlook 2003.
BOOL IsMode2003() const;
Valeur de retour
TRUE si le contrôle d’onglet de barre Outlook est en mode Outlook 2003 ; sinon FALSE ;
Notes
Cette valeur est définie par CMFCOutlookBar ::SetMode2003.
CMFCOutlookBarTabCtrl ::OnShowFewerPageButtons
Appelé par l’infrastructure pour réduire le nombre de boutons de page d’onglets visibles.
virtual void OnShowFewerPageButtons();
Notes
Cette méthode ajuste le nombre de boutons d’onglet de page visibles lorsque le contrôle est redimensionné.
CMFCOutlookBarTabCtrl ::OnShowMorePageButtons
Appelé par l’infrastructure pour augmenter le nombre de boutons de page d’onglets visibles.
virtual void OnShowMorePageButtons();
Notes
Cette méthode ajuste le nombre de boutons de page d’onglets visibles lorsque le contrôle est redimensionné.
CMFCOutlookBarTabCtrl ::OnShowOptions
Affiche la boîte de dialogue Options du volet de navigation.
virtual void OnShowOptions();
Notes
La boîte de dialogue Options du volet de navigation permet à l’utilisateur de sélectionner les boutons de page d’onglets à afficher et l’ordre dans lequel ils sont affichés.
Cette méthode est appelée par l’infrastructure lorsque l’utilisateur sélectionne l’élément de menu Options du volet de navigation dans le menu de personnalisation du contrôle.
CMFCOutlookBarTabCtrl ::SetActiveTab
Définit l’onglet actif. L’onglet actif est celui ouvert, avec son contenu visible.
virtual BOOL SetActiveTab(int iTab);
Paramètres
Ccfi
[in] Index de base zéro d’un onglet à ouvrir.
Valeur de retour
Différent de zéro si l’onglet spécifié a été ouvert avec succès ; sinon 0.
Notes
L’effet visuel de la définition de l’onglet actif dépend de l’activation de l’animation. Pour plus d’informations, consultez CMFCOutlookBarTabCtrl ::EnableAnimation.
CMFCOutlookBarTabCtrl ::SetBorderSize
Définit la taille de bordure du contrôle d’onglet Outlook.
void SetBorderSize(int nBorderSize);
Paramètres
nBorderSize
[in] Spécifie la nouvelle taille de bordure en pixels.
Notes
Définit la nouvelle taille de bordure et recalcule la disposition de la fenêtre Outlook.
CMFCOutlookBarTabCtrl ::SetPageButtonTextAlign
Définit l’alignement des étiquettes de texte sur les boutons d’onglet de la barre Outlook.
void SetPageButtonTextAlign(
UINT uiAlign,
BOOL bRedraw=TRUE);
Paramètres
uiAlign
[in] Spécifie l’alignement du texte.
bRedraw
[in] Si la valeur est TRUE, la fenêtre Outlook est redessinée.
Notes
Utilisez cette fonction pour modifier l’alignement du texte pour les boutons de page.
uiAlign peut être l’une des valeurs suivantes :
| Constant | Signification |
|---|---|
| TA_LEFT | Alignement gauche |
| TA_CENTER | Alignement central |
| TA_RIGHT | Alignement droit |
La valeur par défaut est TA_CENTER.
CMFCOutlookBarTabCtrl ::SetToolbarImageList
Définit la bitmap qui contient les icônes affichées en bas de la barre Outlook en mode Outlook 2003.
BOOL SetToolbarImageList(
UINT uiID,
int cx,
COLORREF clrTransp=RGB(255, 0, 255));
Paramètres
uiID
[in] Spécifie l’ID de ressource de l’image à charger.
Cx
[in] Spécifie la largeur d’une image dans la liste d’images, en pixels.
clrTransp
[in] Valeur RVB qui spécifie la couleur transparente.
Valeur de retour
Retourne TRUE en cas de réussite ; retourne sinon FALSE.
Notes
Utilisez cette fonction pour joindre une liste d’images dont les images seront affichées sur les boutons de barre d’outils en mode Microsoft Bureau 2003. Les index d’image doivent correspondre aux index de page.
Cette méthode ne doit pas être appelée si elle n’est pas en mode Microsoft Bureau 2003. Pour plus d’informations, consultez CMFCOutlookBar, classe.
CMFCOutlookBarTabCtrl ::SetVisiblePageButtons
void SetVisiblePageButtons(int nVisiblePageButtons);
Paramètres
[in] nVisiblePageButtons
Notes
Voir aussi
Graphique hiérarchique
Classes
CMFCBaseTabCtrl, classe
CMFCOutlookBar, classe
CMFCOutlookBarPane, classe
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour