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
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 dwControlBarStyleCBasePane ::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 case activée 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
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