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

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCOutlookBarTabCtrl

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’onglet, la légende de la page s’affiche 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

iTab
[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 Office 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 Office 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