CMFCOutlookBar, classe

Article
06/10/2015

Un volet avec tabulation avec l'apparence visuelle Volet de navigation dans Microsoft Outlook 2000 et Outlook 2003. L'objet d' CMFCOutlookBar contient un objet de CMFCOutlookBarTabCtrl, classe et séries d'onglets. Les tabulations peuvent être des objets de CMFCOutlookBarPane, classe ou CWnd- objets dérivés. À l'utilisateur, la barre Outlook apparaît comme un ensemble de boutons et d'une zone d'affichage. Lorsque l'utilisateur clique sur un bouton, le volet de contrôle correspondant ou du bouton est affiché.

class CMFCOutlookBar : public CBaseTabbedPane

Membres

Constructeurs publics

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

Méthodes publiques

Nom	Description
CMFCOutlookBar::AllowDestroyEmptyTabbedPane	Spécifie si un volet avec tabulation vide peut être perdues. (Substitutions CBaseTabbedPane::AllowDestroyEmptyTabbedPane.)
CMFCOutlookBar::CanAcceptPane	Détermine si un autre volet peut être ancré au volet de barre Outlook. (Substitutions CDockablePane::CanAcceptPane.)
CMFCOutlookBar::CanSetCaptionTextToTabName	Détermine si la légende pour le volet avec tabulation affiche le même texte de l'onglet actif. (Substitutions CBaseTabbedPane::CanSetCaptionTextToTabName.)
CMFCOutlookBar::Create	Crée le contrôle de barre Outlook.
CMFCOutlookBar::CreateCustomPage	Crée une barre personnalisée tableau Outlook.
CMFCOutlookBar::CreateObject	Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe.
CMFCOutlookBar::DoesAllowDynInsertBefore	Détermine si un utilisateur peut ancrer une barre de contrôles au bord externe de la barre Outlook.
CMFCOutlookBar::FloatTab	Flotte un volet, mais uniquement si le volet se trouve actuellement dans une table détachable. (Substitutions CBaseTabbedPane::FloatTab.)
CMFCOutlookBar::GetButtonsFont	Retourne la police du texte sur les boutons de la barre Outlook.
CMFCOutlookBar::GetTabArea	Retourne la taille et la position des zones d'onglet sur la barre Outlook. (Substitutions CBaseTabbedPane::GetTabArea.)
CMFCOutlookBar::GetThisClass	Utilisé par l'infrastructure pour obtenir un pointeur vers l'objet d' CRuntimeClass associé à ce type de classe.
CMFCOutlookBar::IsMode2003	Détermine si le comportement des imitateurs de barre Outlook qui Microsoft Office Outlook 2003 (consultez les notes).
CMFCOutlookBar::OnAfterAnimation	Appelé par CMFCOutlookBarTabCtrl::SetActiveTab après l'onglet actif a été défini à l'aide de l'animation.
CMFCOutlookBar::OnBeforeAnimation	Appelé par CMFCOutlookBarTabCtrl::SetActiveTab avant une page d'onglets est défini comme onglet actif à l'aide de l'animation.
CMFCOutlookBar::OnScroll	Appelé par l'infrastructure si la barre Outlook fait défiler vers le haut ou vers le bas.
CMFCOutlookBar::RemoveCustomPage	Supprime une barre personnalisée tableau Outlook.
CMFCOutlookBar::SetButtonsFont	Définit la police du texte sur les boutons de la barre Outlook.
CMFCOutlookBar::SetMode2003	Spécifie si le comportement des imitateurs de barre Outlook qui Outlook 2003 (consultez les notes).

Notes

Pour obtenir un exemple d'une barre Outlook, consultez Exemple OutlookDemo : Application MFC OutlookDemo.

Implémenter la barre Outlook

Pour utiliser le contrôle d' CMFCOutlookBar dans votre application, suivez ces étapes :

Incluez un objet d' CMFCOutlookBar dans la classe de fenêtre frame principale.

class CMainFrame : public CMDIFrameWnd
 { ...
     CMFCOutlookBar         m_wndOutlookBar;
     CMFCOutlookBarPane     m_wndOutlookPane;
... };

Lors de le traitement du message d' WM_CREATE dans le frame principal, appelez la méthode de CMFCOutlookBar::Create pour créer le contrôle onglet de barre Outlook.
```
m_wndOutlookBar.Create (_T("Shortcuts"), this, CRect (0, 0, 100, 100), ID_VIEW_OUTLOOKBAR, WS_CHILD | WS_VISIBLE | CBRS_LEFT);
```
Obtient un pointeur vers CMFCOutlookBarTabCtrl sous-jacent à l'aide de CBaseTabbedPane::GetUnderlyingWindow.
```
CMFCOutlookBarTabCtrl* pOutlookBar = (CMFCOutlookBarTabCtrl*) m_wndOutlookBar.GetUnderlyingWindow ();
```

Créez un objet de CMFCOutlookBarPane, classe pour chaque onglet qui contient des boutons.

m_wndOutlookPane.Create (&m_wndOutlookBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_OUTLOOK_PANE_GENERAL, AFX_CBRS_FLOAT | AFX_CBRS_RESIZE);
// make the Outlook pane detachable (enable docking)
m_wndOutlookPane.EnableDocking (CBRS_ALIGN_ANY);
// add buttons
m_wndOutlookPane.AddButton (theApp.LoadIcon (IDR_MAINFRAME), "About", ID_APP_ABOUT);
m_wndOutlookPane.AddButton (theApp.LoadIcon (IDR_CUSTOM_OPEN_ICON), "Open", ID_FILE_OPEN);

Appelez CMFCBaseTabCtrl::AddTab pour ajouter chaque nouvelle table. Affectez au paramètre d' bDetachable à FALSE pour rendre une page non détachable. Ou, utilisez CMFCOutlookBarTabCtrl::AddControl d'ajouter des pages détachables.
```
pOutlookBar->AddTab (&m_wndOutlookPane, "General", (UINT) -1, TRUE); 
```
Pour ajouter CWnd- le contrôle dérivé (par exemple, CMFCShellTreeCtrl, classe) comme onglet, créez le contrôle et l'appel CMFCBaseTabCtrl::AddTab pour l'ajouter à la barre Outlook.

Notes

Vous devez utiliser des identificateurs uniques de contrôle pour chaque objet de CMFCOutlookBarPane, classe et pour chaque CWndobjet dérivé.

Pour ajouter dynamiquement ou supprimer des nouvelles pages au moment de l'exécution, utilisez CMFCOutlookBar::CreateCustomPage et CMFCOutlookBar::RemoveCustomPage.

Mode Outlook 2003

En mode Outlook 2003, les boutons de l'onglet sont positionnés en bas du volet de barre Outlook. Lorsqu'il n'y a pas suffisamment de place pour afficher des boutons, ils sont affichés comme icônes dans une zone comme une barre d'outils le long de le bas du volet.

Utilisation CMFCOutlookBar::SetMode2003 d'activer le mode Outlook 2003. Utilisez CMFCOutlookBarTabCtrl::SetToolbarImageList pour définir la bitmap qui contient les icônes affichées en bas de la barre Outlook. Les icônes dans la bitmap doivent être classées par index de tabulation.