Partager via


CMFCOutlookBarPane, classe

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

Contrôle dérivé de la classe CMFCToolBar qui peut être inséré dans une barre Outlook ( classe CMFCOutlookBar). Le volet de barre Outlook contient une colonne de grands boutons. L'utilisateur peut faire défiler vers le haut ou vers le bas la liste des boutons si elle est plus grande que le volet. Lorsque l'utilisateur détache un volet de barre Outlook de la barre Outlook, il peut flotter ou s'ancrer à la fenêtre frame principale.

Syntaxe

class CMFCOutlookBarPane : public CMFCToolBar

Membres

Constructeurs publics

Nom Description
CMFCOutlookBarPane::CMFCOutlookBarPane Constructeur par défaut.
CMFCOutlookBarPane::~CMFCOutlookBarPane Destructeur.

Méthodes publiques

Nom Description
CMFCOutlookBarPane ::AddButton Ajoute un bouton au volet de barre Outlook.
CMFCOutlookBarPane ::CanBeAttached Détermine si le volet peut être ancré dans une autre fenêtre de volet ou de cadre. (Remplacements CBasePane ::CanBeAttached.)
CMFCOutlookBarPane::CanBeRestored Détermine si le système peut restaurer une barre d’outils à son état d’origine après la personnalisation. (Remplacements CMFCToolBar ::CanBeRestored.)
CMFCOutlookBarPane ::ClearAll Libère les ressources utilisées par les images dans le volet de barre Outlook.
CMFCOutlookBarPane ::Create Crée le volet de barre Outlook.
CMFCOutlookBarPane::CreateObject Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe.
CMFCOutlookBarPane::Dock Appelé par l’infrastructure pour ancrer le volet de barre Outlook. (Substitue CPane::Dock.)
CMFCOutlookBarPane ::EnablePageScrollMode Spécifie si les flèches de défilement du volet de barre Outlook avancent la liste des boutons par page ou par bouton.
CMFCOutlookBarPane ::GetRegularColor Retourne la couleur de texte standard (non sélectionnée) du volet de barres Outlook.
CMFCOutlookBarPane::GetThisClass Utilisé par l’infrastructure pour obtenir un pointeur vers l’objet CRuntimeClass associé à ce type de classe.
CMFCOutlookBarPane ::IsBackgroundTexture Détermine s’il existe une image d’arrière-plan chargée pour le volet de barre Outlook.
CMFCOutlookBarPane::IsChangeState Détermine si un volet flottant peut être ancré. (Substitue CPane::IsChangeState.)
CMFCOutlookBarPane ::IsDrawShadedHighlight Détermine si la bordure du bouton est ombrée lorsqu’un bouton est mis en surbrillance et qu’une image d’arrière-plan s’affiche.
CMFCOutlookBarPane::OnBeforeFloat Appelé par l’infrastructure lorsqu’un volet est sur le point de flotter. (Remplacements CPane ::OnBeforeFloat.)
CMFCOutlookBarPane ::RemoveButton Supprime le bouton qui a un ID de commande spécifié.
CMFCOutlookBarPane::RestoreOriginalstate Restaure l'état initial d'une barre d'outils. (Remplacements CMFCToolBar ::RestoreOriginalState.)
CMFCOutlookBarPane ::SetBackColor Définit la couleur d’arrière-plan.
CMFCOutlookBarPane ::SetBackImage Définit l’image d’arrière-plan.
CMFCOutlookBarPane ::SetDefaultState Réinitialise le volet de barre Outlook à l’ensemble de boutons d’origine.
CMFCOutlookBarPane ::SetExtraSpace Définit le nombre de pixels de remplissage utilisés autour des boutons dans le volet de barre Outlook.
CMFCOutlookBarPane ::SetTextColor Définit les couleurs du texte normal et mis en surbrillance dans le volet de barre Outlook.
CMFCOutlookBarPane ::SetTransparentColor Définit la couleur transparente pour le volet de barres Outlook.
CMFCOutlookBarPane::SmartUpdate Utilisé en interne pour mettre à jour la barre Outlook. (Substitue CMFCToolBar::SmartUpdate.)

Méthodes protégées

Nom Description
CMFCOutlookBarPane ::EnableContextMenuItems Spécifie les éléments de menu contextuel affichés en mode de personnalisation.
CMFCOutlookBarPane ::RemoveAllButtons Supprime tous les boutons du volet de barre Outlook. (Remplacements CMFCToolBar ::RemoveAllButtons.)

Notes

Pour plus d’informations sur l’implémentation d’une barre Outlook, consultez CMFCOutlookBar, classe.

Pour obtenir un exemple de barre Outlook, consultez l’exemple de projet OutlookDemo.

Exemple

L’exemple suivant montre comment utiliser différentes méthodes de la CMFCOutlookBarPane classe. L’exemple montre comment créer un volet de barre Outlook, activer le mode de défilement de la page, activer l’ancrage et définir la couleur d’arrière-plan de la barre Outlook. Cet extrait de code fait partie de l’exemple Outlook Multi Views.

CMFCOutlookBarPane m_wndShortcutsPane1;
CImageList images;
images.Create(IDB_SHORTCUTS, 32, 0, RGB(255, 0, 255));

// Create first page:
m_wndShortcutsPane1.Create(&m_wndShortcutsBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_SHORTCUTS_PANE_1);
// The this pointer points to a CMainFrame class which extends the CFrameWnd class
m_wndShortcutsPane1.SetOwner(this);
m_wndShortcutsPane1.EnableTextLabels();
m_wndShortcutsPane1.EnableDocking(CBRS_ALIGN_ANY);
m_wndShortcutsPane1.EnablePageScrollMode();
m_wndShortcutsPane1.SetBackColor(RGB(0, 255, 0));

m_wndShortcutsPane1.AddButton(images.ExtractIcon(0), _T("View 1"), ID_SHORTCUT_1);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(1), _T("View 2"), ID_SHORTCUT_2);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(2), _T("View 3"), ID_SHORTCUT_3);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(3), _T("View 4"), ID_SHORTCUT_4);

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCOutlookBarPane

Spécifications

En-tête : afxoutlookbarpane.h

CMFCOutlookBarPane ::AddButton

Ajoute un bouton au volet de barre Outlook.

BOOL AddButton(
    UINT uiImage,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    UINT uiImage,
    UINT uiLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    LPCTSTR szBmpFileName,
    LPCTSTR szLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HBITMAP hBmp,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HICON hIcon,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1,
    BOOL bAlphaBlend=FALSE);

Paramètres

uiImage
[in] Spécifie l’identificateur de ressource d’une bitmap.

lpszLabel
[in] Spécifie le texte du bouton.

iIdCommand
[in] Spécifie l’ID du contrôle de bouton.

iInsertAt
[in] Spécifie l’index de base zéro sur la page de la barre Outlook à laquelle insérer le bouton.

uiLabel
[in] ID de ressource de chaîne.

szBmpFileName
[in] Spécifie le nom du fichier image de disque à charger.

szLabel
[in] Spécifie le texte du bouton.

hBmp
[in] Handle de la bitmap d’un bouton.

hIcon
[in] Poignée vers une icône de boutons.

Valeur de retour

TRUE si un bouton a été ajouté avec succès ; sinon FALSE.

Notes

Utilisez cette méthode pour insérer un nouveau bouton dans la page d’une barre Outlook. L’image du bouton peut être chargée à partir des ressources de l’application ou à partir d’un fichier disque.

Si l’ID de page spécifié par uiPageID est -1, le bouton est inséré dans la première page.

Si l’index spécifié par iInsertAt est -1, le bouton est ajouté à la fin de la page.

CMFCOutlookBarPane ::CanBeAttached

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

virtual BOOL CanBeAttached() const;

Valeur de retour

Notes

CMFCOutlookBarPane ::ClearAll

Libère les ressources utilisées par les images dans le volet de barre Outlook.

void ClearAll();

Notes

Cette méthode appelle directement CMFCToolBarImages ::Clear, qui est appelée sur les images utilisées par le volet de barres Outlook.

CMFCOutlookBarPane ::Create

Crée le volet de barre Outlook.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT uiID=(UINT)-1,
    DWORD dwControlBarStyle=0);

Paramètres

pParentWnd
[in] Spécifie la fenêtre parente du contrôle du volet de barres Outlook. Ne doit pas avoir la valeur Null.

dwStyle
[in] Style de fenêtre. Pour obtenir la liste des styles de fenêtre, consultez Styles de fenêtre.

uiID
[in] ID de contrôle. Doit être unique pour permettre l’enregistrement de l’état du contrôle.

dwControlBarStyle
[in] Spécifie des styles spéciaux qui définissent le comportement du contrôle du volet de barres Outlook lorsqu’il est détaché de la barre Outlook.

Valeur de retour

TRUE si la méthode a réussi ; sinon FALSE.

Notes

Pour construire un CMFCOutlookBarPane objet, appelez d’abord le constructeur, puis appelez Create, ce qui crée le contrôle du volet de barres Outlook et l’attache à l’objet CMFCOutlookBarPane .

Pour plus d’informations sur dwControlBarStyle CBasePane ::CreateEx.

CMFCOutlookBarPane ::EnableContextMenuItems

Spécifie les éléments de menu contextuel affichés en mode de personnalisation.

virtual BOOL EnableContextMenuItems(
    CMFCToolBarButton* pButton,
    CMenu* pPopup);

Paramètres

pButton
[in] Pointeur vers un bouton de barre d’outils sur lequel un utilisateur a cliqué.

pPopup
[in] Pointeur vers le menu contextuel.

Valeur de retour

Retourne TRUE si le menu contextuel doit être affiché ; sinon FALSE.

Notes

Remplacez cette méthode pour modifier le menu contextuel standard de l’infrastructure que l’infrastructure affiche en mode de personnalisation.

L’implémentation par défaut vérifie le mode de personnalisation ( CMFCToolBar ::IsCustomizeMode) et, s’il est défini sur TRUE, désactive tous les éléments de menu contextuel à l’exception de Delete. Ensuite, il transmet simplement les paramètres d’entrée à CMFCToolBar::EnableContextMenuItems.

Remarque

Le menu contextuel est un synonyme du menu contextuel.

CMFCOutlookBarPane ::EnablePageScrollMode

Spécifie si les flèches de défilement du volet de barre Outlook avancent la liste des boutons par page ou bouton par bouton.

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

Paramètres

bPageScroll
[in] Si la valeur est TRUE, activez le mode de défilement de la page. Si la valeur est FALSE, désactivez le mode de défilement de la page.

CMFCOutlookBarPane ::GetRegularColor

Retourne la couleur de texte standard (autrement dit, non sélectionnée) du volet de barres Outlook.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Valeur de retour

Couleur de texte actuelle sous forme de valeur de couleur RVB.

Notes

Utilisez CMFCOutlookBarPane ::SetTextColor pour définir la couleur de texte actuelle (régulière et sélectionnée) de la barre Outlook. Vous pouvez obtenir la couleur de texte par défaut en appelant la fonction GetSysColor avec l’index COLOR_WINDOW.

CMFCOutlookBarPane ::IsBackgroundTexture

Détermine s’il existe une image d’arrière-plan chargée pour le volet de barre Outlook.

BOOL IsBackgroundTexture() const;

Valeur de retour

TRUE s’il existe une image d’arrière-plan à afficher ; sinon FALSE.

Notes

Vous pouvez ajouter une image d’arrière-plan en appelant la fonction CMFCOutlookBarPane ::SetBackImage .

S’il n’existe aucune image d’arrière-plan, l’arrière-plan est peint avec une couleur spécifiée à l’aide de CMFCOutlookBarPane ::SetBackColor.

CMFCOutlookBarPane ::IsDrawShadedHighlight

Détermine si la bordure du bouton est ombrée lorsqu’un bouton est mis en surbrillance et qu’une image d’arrière-plan s’affiche.

BOOL IsDrawShadedHighlight() const;

Valeur de retour

TRUE si les bordures du bouton sont ombrées ; sinon FALSE.

CMFCOutlookBarPane ::RemoveAllButtons

Supprime tous les boutons du volet de barre Outlook.

virtual void RemoveAllButtons();

CMFCOutlookBarPane ::RemoveButton

Supprime le bouton qui a un ID de commande spécifié.

BOOL RemoveButton(UINT iIdCommand);

Paramètres

iIdCommand
[in] Spécifie l’ID de commande d’un bouton à supprimer.

Valeur de retour

TRUE si le bouton a été supprimé avec succès ; FALSE si l’ID de commande spécifié n’est pas valide.

CMFCOutlookBarPane ::SetBackColor

Définit la couleur d’arrière-plan de la barre Outlook.

void SetBackColor(COLORREF color);

Paramètres

color
[in] Spécifie la nouvelle couleur d’arrière-plan.

Notes

Appelez cette fonction pour définir la couleur d’arrière-plan actuelle pour la barre Outlook. La couleur d’arrière-plan est utilisée uniquement s’il n’existe aucune image d’arrière-plan.

CMFCOutlookBarPane ::SetBackImage

Définit l’image d’arrière-plan.

void SetBackImage(UINT uiImageID);

Paramètres

uiImageID
[in] Spécifie l’ID de ressource d’image.

Notes

Appelez cette méthode pour définir l’image d’arrière-plan de la barre Outlook. La liste des images d’arrière-plan est gérée par l’objet CMFCToolBarImages Class incorporé.

CMFCOutlookBarPane ::SetDefaultState

Réinitialise le volet de barre Outlook à l’ensemble de boutons d’origine.

void SetDefaultState();

Notes

Cette méthode restaure les boutons de barre Outlook dans l’ensemble d’origine. Cette méthode est semblable CMFCOutlookBarPane::RestoreOriginalstate, sauf qu’elle ne déclenche pas de redessination du volet de barres Outlook.

CMFCOutlookBarPane ::SetExtraSpace

Définit le nombre de pixels de remplissage utilisés autour des boutons dans le volet de barre Outlook.

void SetExtraSpace()

CMFCOutlookBarPane ::SetTextColor

Définit les couleurs du texte normal et mis en surbrillance dans le volet de barre Outlook.

void SetTextColor(
    COLORREF clrRegText,
    COLORREF clrSelText=0);

Paramètres

clrRegText
[in] Spécifie la nouvelle couleur pour le texte non sélectionné.

clrSelText
[in] Spécifie la nouvelle couleur pour le texte sélectionné.

CMFCOutlookBarPane ::SetTransparentColor

Définit la couleur transparente pour le volet de barres Outlook.

void SetTransparentColor(COLORREF color);

Paramètres

color
Spécifie la nouvelle couleur transparente.

Notes

La couleur transparente est nécessaire pour afficher des images transparentes. Toute occurrence de cette couleur dans une image est peinte avec la couleur d’arrière-plan à la place. Il n’existe aucun mélange d’images d’arrière-plan et de premier plan.

Voir aussi

Graphique hiérarchique
Classes
CMFCToolBar, classe
CMFCOutlookBar, classe
CMFCOutlookBarTabCtrl, classe