CMFCOutlookBar-Klasse

Artikel
06/10/2015

Eine Seite im Registerformat mit dem Aussehen Navigationsbereich in Microsoft Outlook 2000 oder in Outlook 2003. Das CMFCOutlookBar-Objekt enthält ein CMFCOutlookBarTabCtrl-Klasse-Objekt und von Registerkarten. Die Registerkarten können entweder CMFCOutlookBarPane-Klasse-Objekte oder CWnd sein abgeleitete Objekte. Wenn Benutzer wird die Outlook-Leiste als eine Reihe von Schaltflächen und Anzeigebereich. Wenn der Benutzer auf eine Schaltfläche klickt, wird der entsprechende Steuerelement- oder Schaltflächenbereich angezeigt.

class CMFCOutlookBar : public CBaseTabbedPane

Mitglieder

Öffentliche Konstruktoren

Name	Beschreibung
CMFCOutlookBar::CMFCOutlookBar	Standardkonstruktor.
CMFCOutlookBar::~CMFCOutlookBar	Destruktor.

Öffentliche Methoden

Name	Beschreibung
CMFCOutlookBar::AllowDestroyEmptyTabbedPane	Gibt an, ob eine leere Seite im Registerformat zerstört werden kann. (Überschreibungen CBaseTabbedPane::AllowDestroyEmptyTabbedPane.)
CMFCOutlookBar::CanAcceptPane	Bestimmt, ob ein anderer Bereich zum Outlook-Leistebereich angedockt werden kann. (Überschreibungen CDockablePane::CanAcceptPane.)
CMFCOutlookBar::CanSetCaptionTextToTabName	Bestimmt, ob die Beschriftung für die Seite im Registerformat den gleichen Text wie die aktive Registerkarte angezeigt wird. (Überschreibungen CBaseTabbedPane::CanSetCaptionTextToTabName.)
CMFCOutlookBar::Create	Erstellt das Outlook-Leistensteuerelement.
CMFCOutlookBar::CreateCustomPage	Erstellt eine benutzerdefinierte Outlook-Leisteregisterkarte.
CMFCOutlookBar::CreateObject	Wird vom Framework, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCOutlookBar::DoesAllowDynInsertBefore	Bestimmt, ob ein Benutzer eine Steuerleiste an den äußeren Rand der Outlook-Leiste andocken kann.
CMFCOutlookBar::FloatTab	Schwimmt einen Bereich, jedoch nur, wenn der Bereich sich gegenwärtig in einer abnehmbaren Registerkarte befindet. (Überschreibungen CBaseTabbedPane::FloatTab.)
CMFCOutlookBar::GetButtonsFont	Gibt die Schriftart des Textes in den Schaltflächen der Outlook-Leiste zurück.
CMFCOutlookBar::GetTabArea	Gibt die Größe und Position der Registerkartenbereiche auf der Outlook-Leiste zurück. (Überschreibungen CBaseTabbedPane::GetTabArea.)
CMFCOutlookBar::GetThisClass	Wird vom Framework, um ein Zeiger auf CRuntimeClass-Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCOutlookBar::IsMode2003	Bestimmt ob das Verhalten der Outlook-Leistenachahmer, die von Microsoft Office Outlook 2003 (siehe Hinweise).
CMFCOutlookBar::OnAfterAnimation	Aufgerufen durch CMFCOutlookBarTabCtrl::SetActiveTab nach der aktiven Registerkarte kann mithilfe der Animation festgelegt.
CMFCOutlookBar::OnBeforeAnimation	Aufgerufen durch CMFCOutlookBarTabCtrl::SetActiveTab, bevor eine Registerkarte als aktuelle Registerkarte mithilfe der Animation festgelegt ist.
CMFCOutlookBar::OnScroll	Aufgerufen vom Framework, wenn die Outlook-Leiste oben oder unten durch.
CMFCOutlookBar::RemoveCustomPage	Entfernt eine benutzerdefinierte Outlook-Leisteregisterkarte.
CMFCOutlookBar::SetButtonsFont	Legt die Schriftart des Textes in den Schaltflächen der Outlook-Leiste fest.
CMFCOutlookBar::SetMode2003	Gibt ob das Verhalten der Outlook-Leistenachahmer an, die von Outlook 2003 (siehe Hinweise).

Hinweise

Ein Beispiel einer Outlook-Leiste, finden Sie unter OutlookDemo-Beispiel: MFC-OutlookDemo-Anwendung.

Implementieren der Outlook-Leiste

Um das CMFCOutlookBar-Steuerelement in der Anwendung zu verwenden, führen Sie folgende Schritte aus:

Betten Sie ein CMFCOutlookBar-Objekt in die Hauptrahmenfensterklasse ein.

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

Wenn Sie die WM_CREATE Meldung im Hauptframes verarbeiten, rufen Sie die CMFCOutlookBar::Create-Methode auf, um das Outlook-Leistetab-steuerelement zu erstellen.
```
m_wndOutlookBar.Create (_T("Shortcuts"), this, CRect (0, 0, 100, 100), ID_VIEW_OUTLOOKBAR, WS_CHILD | WS_VISIBLE | CBRS_LEFT);
```
Abrufen eines Zeigers auf zugrunde liegenden CMFCOutlookBarTabCtrl, indem er CBaseTabbedPane::GetUnderlyingWindow verwendet.
```
CMFCOutlookBarTabCtrl* pOutlookBar = (CMFCOutlookBarTabCtrl*) m_wndOutlookBar.GetUnderlyingWindow ();
```

Erstellen Sie ein CMFCOutlookBarPane-Klasse-Objekt für jede Registerkarte, die Schaltflächen enthält.

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);

Rufen Sie CMFCBaseTabCtrl::AddTab auf, um jede neue Registerkarte hinzuzufügen. Legen Sie den bDetachable-Parameter zu FALSE fest, um eine Seite nicht-abnehmbar auszuführen. Oder, Verwendung CMFCOutlookBarTabCtrl::AddControl, abnehmbare Seiten hinzuzufügen.
```
pOutlookBar->AddTab (&m_wndOutlookPane, "General", (UINT) -1, TRUE); 
```
So CWnd hinzufügen von abgeleitetes Steuerelement (beispielsweise, CMFCShellTreeCtrl-Klasse) als Registerkarte, erstellen das Steuerelement und den Aufruf CMFCBaseTabCtrl::AddTab, um es der Outlook-Leiste hinzuzufügen.

Hinweis

Sie sollten eindeutige Steuer-IDs für jedes Objekt CMFCOutlookBarPane-Klasse und für jedes CWnd verwenden von abgeleitetes Objekt.

So fügen Sie neue Seiten, verwendet CMFCOutlookBar::CreateCustomPage und CMFCOutlookBar::RemoveCustomPage dynamisch zur Laufzeit hinzufügen oder löschen.

Outlook 2003-Modus

In Outlook 2003-Modus werden die Registerkartenschaltflächen am unteren Rand des Outlook-Leistebereich positioniert. Wenn nicht genügend Platz, die Schaltflächen anzuzeigen, werden sie als Symbole in einem Symbolleiste ähnlichen Bereich entlang dem unteren Rand des Bereichs angezeigt.

Verwendung CMFCOutlookBar::SetMode2003, Outlook 2003-Modus zu aktivieren. Verwenden Sie CMFCOutlookBarTabCtrl::SetToolbarImageList, um die Bitmap festzulegen, die die Symbole enthält, die an der Unterkante der Outlook-Leiste angezeigt werden. Die Symbole in der Bitmap müssen durch Registerkartenindex sortiert werden.