Freigeben über


CMFCOutlookBarTabCtrl-Klasse

Ein Registerkarten-Steuerelement mit dem Aussehen des Navigationsbereichs in Microsoft Outlook verfügt. Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer Visual Studio-Installation.

Syntax

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl Der Standardkonstruktor.
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl Destruktor.

Öffentliche Methoden

Name Beschreibung
CMFCOutlookBarTabCtrl::AddControl Fügt ein Windows-Steuerelement als neue Registerkarte in der Outlook-Leiste hinzu.
CMFCOutlookBarTabCtrl::CalcRectEdit Wird vom Framework aufgerufen, um die Dimensionen des Bearbeitungsfelds zu bestimmen, das angezeigt wird, wenn ein Benutzer eine Registerkarte umbenennt CMFCBaseTabCtrl::CalcRectEdit. (Überschreibt .)
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons Wird vom Framework bei Größenänderungsvorgängen aufgerufen, um zu ermitteln, ob weniger Schaltflächen für die Registerkartenseite von Outlook-Leisten angezeigt werden können, als derzeit sichtbar sind.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons Wird vom Framework bei Größenänderungsvorgängen aufgerufen, um zu ermitteln, ob mehr Schaltflächen auf der Registerkartenseite von Outlook-Leiste angezeigt werden können, als derzeit sichtbar sind.
CMFCOutlookBarTabCtrl::Create Erstellt das Registerkartensteuerelement der Outlook-Leiste.
CMFCOutlookBarTabCtrl::CreateObject Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCOutlookBarTabCtrl::EnableAnimation Gibt an, ob die Animation, die während des Wechsels zwischen aktiven Registerkarten auftritt, aktiviert ist.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit Gibt an, ob ein Benutzer die Textbeschriftungen auf den Registerkartenschaltflächen der Outlook-Leiste ändern kann. (Außerkraftsetzungen CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCOutlookBarTabCtrl::EnableScrollButtons Vom Framework aufgerufen, um Schaltflächen zu aktivieren, mit denen der Benutzer im Outlook-Leistenbereich durch Schaltflächen scrollen kann.
CMFCOutlookBarTabCtrl::FindTargetWnd Identifiziert den Bereich, der einen angegebenen Punkt enthält. (Außerkraftsetzungen CMFCBaseTabCtrl::FindTargetWnd.)
CMFCOutlookBarTabCtrl::GetBorderSize Gibt die Rahmengröße des Outlook-Registerkartensteuerelements zurück.
CMFCOutlookBarTabCtrl::GetTabArea Ruft die Größe und Position des Registerkartenbereichs des Registerkartensteuerelements ab. (Außerkraftsetzungen CMFCBaseTabCtrl::GetTabArea.)
CMFCOutlookBarTabCtrl::GetThisClass Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation Bestimmt, ob die Animation, die während des Wechsels zwischen aktiven Registerkarten auftritt, aktiviert ist.
CMFCOutlookBarTabCtrl::IsMode2003 Bestimmt, ob sich das Registerkartensteuerelement der Outlook-Leiste in einem Modus befindet, der Microsoft Outlook 2003 emuliert.
CMFCOutlookBarTabCtrl::IsPtInTabArea Bestimmt, ob sich ein Punkt innerhalb des Registerkartenbereichs befindet. (Außerkraftsetzungen CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCOutlookBarTabCtrl::IsTabDetachable Bestimmt, ob eine Registerkarte abtrennbar ist. (Außerkraftsetzungen CMFCBaseTabCtrl::IsTabDetachable.)
CMFCOutlookBarTabCtrl::OnChangeTabs Wird vom Framework aufgerufen, wenn eine Registerkarte eingefügt oder entfernt wird. (Überschreibt CMFCBaseTabCtrl::OnChangeTabs.)
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons Vom Framework aufgerufen, um die Anzahl der sichtbaren Registerkartenseitenschaltflächen zu verringern.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons Wird vom Framework aufgerufen, um die Anzahl der sichtbaren Registerkartenseitenschaltflächen zu erhöhen.
CMFCOutlookBarTabCtrl::OnShowOptions Zeigt das Dialogfeld "Navigationsbereichsoptionen " an.
CMFCOutlookBarTabCtrl::RecalcLayout Berechnet das interne Layout des Registerkartensteuerelements neu. (Außerkraftsetzungen CMFCBaseTabCtrl::RecalcLayout.)
CMFCOutlookBarTabCtrl::SetActiveTab Legt die aktive Registerkarte fest. (Überschreibt CMFCBaseTabCtrl::SetActiveTab.)
CMFCOutlookBarTabCtrl::SetBorderSize Legt die Rahmengröße des Outlook-Registerkartensteuerelements fest.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign Legt die Ausrichtung der Textbeschriftungen auf den Registerkartenschaltflächen der Outlook-Leiste fest.
CMFCOutlookBarTabCtrl::SetToolbarImageList Legt die Bitmap fest, die die Symbole enthält, die unten auf der Outlook-Leiste im Outlook 2003-Modus angezeigt werden (siehe CMFCOutlookBar-Klasse).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Hinweise

Verwenden Sie ein CMFCOutlookBar Objekt zum Hosten des Registerkartensteuerelements der Outlook-Leiste, um eine Outlook-Leiste zu erstellen, die die Docking-Unterstützung enthält. Weitere Informationen finden Sie unter CMFCOutlookBar Class.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie ein CMFCOutlookBarTabCtrl Objekt initialisiert und verschiedene Methoden in der CMFCOutlookBarTabCtrl Klasse verwendet werden. Das Beispiel zeigt, wie Sie die direkte Bearbeitung der Textbeschriftung auf den Schaltflächen der Registerkartenseite der Outlook-Leiste aktivieren, die Animation aktivieren, Bildlaufziehpunkte aktivieren, mit denen der Benutzer durch Schaltflächen im Outlook-Leistenbereich scrollen kann, die Rahmengröße des Outlook-Registerkartensteuerelements festlegen und die Ausrichtung der Textbeschriftungen auf den Registerkartenschaltflächen der Outlook-Leiste festlegen. Dieser Codeausschnitt ist Teil des Outlook Demo-Beispiels.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();
pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCOutlookBarTabCtrl

Anforderungen

Header: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Fügt ein Windows-Steuerelement als neue Registerkarte in der Outlook-Leiste hinzu.

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

Parameter

pWndCtrl
[in] Ein Zeiger auf ein hinzuzufügende Steuerelement.

lpszName
[in] Gibt den Namen der Registerkarte an.

bDetachable
[in] Wenn TRUE, wird die Seite als trennbar erstellt.

nImageID
[in] Bildindex in der internen Bildliste, damit das Bild auf der neuen Registerkarte angezeigt wird.

dwControlBarStyle
[in] Gibt die AFX_ CBRS_*-Formatvorlage für umschlossene Andockbereiche an.

Hinweise

Verwenden Sie diese Funktion, um ein Steuerelement als neue Seite einer Outlook-Leiste hinzuzufügen.

Diese Funktion ruft intern cmFCBaseTabCtrl::AddTab auf.

Wenn Sie "bDetachable" auf TRUE festlegen, AddControl wird intern ein CDockablePaneAdapter Objekt erstellt und das hinzugefügte Steuerelement umbrochen. Sie legt automatisch die Laufzeitklasse des Registerkartenfensters auf die Laufzeitklasse des CMFCOutlookBar unverankerten Frames und die Laufzeitklasse des unverankerten Frames fest CMultiPaneFrameWnd.

Beispiel

Im folgenden Beispiel wird die Verwendung der AddControl Methode in der CMFCOutlookBarTabCtrl Klasse veranschaulicht. Dieser Codeausschnitt ist Teil des Outlook Demo-Beispiels.

// 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

Wird vom Framework bei Größenänderungsvorgängen aufgerufen, um zu bestimmen, ob weniger Schaltflächen für Die Registerkartenseite von Outlook-Leisten angezeigt werden können, als derzeit sichtbar sind.

virtual BOOL CanShowFewerPageButtons() const;

Rückgabewert

TRUE, wenn mehrere Schaltflächen vorhanden sind; andernfalls FALSE.

Hinweise

Das Registerkartensteuerelement der Outlook-Leiste fügt Registerkarten dynamisch hinzu oder entfernt sie aus der Anzeige, je nachdem, wie viel Platz verfügbar ist. Diese Methode wird vom Framework verwendet, um diesen Prozess zu unterstützen.

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Wird vom Framework bei Größenänderungsvorgängen aufgerufen, um zu bestimmen, ob mehr Schaltflächen auf der Registerkartenseite von Outlook-Leisten angezeigt werden können, als derzeit sichtbar sind.

virtual BOOL CanShowMorePageButtons() const;

Rückgabewert

TRUE, wenn schaltflächen vorhanden sind, die zurzeit nicht sichtbar sind; andernfalls FALSE.

Hinweise

Das Registerkartensteuerelement der Outlook-Leiste fügt Registerkarten dynamisch hinzu oder entfernt sie aus der Anzeige, je nachdem, wie viel Platz verfügbar ist. Diese Methode wird vom Framework verwendet, um diesen Prozess zu unterstützen.

CMFCOutlookBarTabCtrl::Create

Erstellt das Registerkartensteuerelement der Outlook-Leiste.

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

Rect
[in] Gibt die anfängliche Größe und Position in Pixeln an.

pParentWnd
[in] Verweist auf das übergeordnete Fenster. Darf nicht NULL sein.

Nid
[in] Die Steuerelement-ID.

Rückgabewert

Nonzero, wenn das Steuerelement erfolgreich erstellt wurde; andernfalls 0.

Hinweise

Normalerweise werden Registerkartensteuerelemente für die Outlook-Leiste erstellt, wenn die CMFCOutlookBar-Klasse die WM_CREATE Nachricht des Prozesses steuert.

CMFCOutlookBarTabCtrl::EnableAnimation

Gibt an, ob die Animation, die während des Wechsels zwischen aktiven Registerkarten auftritt, aktiviert ist.

static void EnableAnimation(BOOL bEnable=TRUE);

Parameter

bEnable
[in] Gibt an, ob die Animation aktiviert oder deaktiviert werden soll.

Hinweise

Rufen Sie diese Funktion auf, um animation zu aktivieren und zu deaktivieren. Wenn der Benutzer eine Registerkartenseite öffnet, wird die Untertitel der Seite nach oben oder unten verschoben, wenn die Animation aktiviert ist. Wenn die Animation deaktiviert ist, wird die Seite sofort aktiv.

Standardmäßig ist die Animation aktiviert.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Gibt an, ob ein Benutzer die Textbeschriftungen auf den Registerkartenseitenschaltflächen der Outlook-Leiste ändern kann.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parameter

bEnable
Wenn WAHR, aktivieren Sie die direkte Bearbeitung der Textbeschriftung. Wenn FALSE, deaktivieren Sie die direkte Bearbeitung.

Hinweise

Rufen Sie diese Funktion auf, um die direkte Bearbeitung von Textbeschriftungen auf Registerkartenseitenschaltflächen zu aktivieren oder zu deaktivieren. Standardmäßig ist die direkte Bearbeitung deaktiviert.

CMFCOutlookBarTabCtrl::EnableScrollButtons

Wird vom Framework aufgerufen, um Bildlaufpunkte zu aktivieren, mit denen der Benutzer im Outlook-Leistenbereich durch Schaltflächen scrollen kann.

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

Parameter

bEnable
[in] Bestimmt, ob die Bildlaufschaltflächen angezeigt werden.

bIsUp
[in] Bestimmt, ob die obere Bildlaufleiste angezeigt wird.

bIsDown
[in] Bestimmt, ob die untere Bildlaufleiste angezeigt wird.

Hinweise

Aktiviert die Anzeige der Bildlaufschaltflächen. Diese Methode wird vom Framework aufgerufen, wenn sich die aktive Registerkarte ändert, um die Bildlaufschaltflächen wiederherzustellen.

CMFCOutlookBarTabCtrl::GetBorderSize

Gibt die Rahmengröße des Outlook-Registerkartensteuerelements zurück.

int GetBorderSize() const;

Rückgabewert

Die Rahmengröße in Pixel.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Rückgabewert

Bemerkungen

CMFCOutlookBarTabCtrl::IsAnimation

Gibt an, ob die Animation, die während des Wechsels zwischen aktiven Registerkarten auftritt, aktiviert ist.

static BOOL IsAnimation();

Rückgabewert

Nonzero, wenn die Animation aktiviert ist; andernfalls 0.

Hinweise

Rufen Sie die CMFCOutlookBarTabCtrl::EnableAnimation-Funktion auf, um animationen zu aktivieren oder zu deaktivieren.

CMFCOutlookBarTabCtrl::IsMode2003

Bestimmt, ob sich das Registerkartensteuerelement der Outlook-Leiste in einem Modus befindet, der Microsoft Outlook 2003 emuliert.

BOOL IsMode2003() const;

Rückgabewert

TRUE, wenn sich das Registerkartensteuerelement der Outlook-Leiste im Outlook 2003-Modus befindet; andernfalls FALSE;

Hinweise

Dieser Wert wird von CMFCOutlookBar::SetMode2003 festgelegt.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Vom Framework aufgerufen, um die Anzahl der sichtbaren Registerkartenseitenschaltflächen zu verringern.

virtual void OnShowFewerPageButtons();

Hinweise

Diese Methode passt die Anzahl der sichtbaren Seitenregisterschaltflächen an, wenn die Größe des Steuerelements geändert wird.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Wird vom Framework aufgerufen, um die Anzahl der sichtbaren Registerkartenseitenschaltflächen zu erhöhen.

virtual void OnShowMorePageButtons();

Hinweise

Diese Methode passt die Anzahl der Registerkartenseitenschaltflächen an, die angezeigt werden, wenn die Größe des Steuerelements geändert wird.

CMFCOutlookBarTabCtrl::OnShowOptions

Zeigt das Dialogfeld "Navigationsbereichsoptionen " an.

virtual void OnShowOptions();

Hinweise

Im Dialogfeld "Optionen für den Navigationsbereich " kann der Benutzer auswählen, welche Registerkartenseitenschaltflächen angezeigt werden sollen, und die Reihenfolge, in der sie angezeigt werden.

Diese Methode wird vom Framework aufgerufen, wenn der Benutzer das Menüelement "Navigationsbereichsoptionen " aus dem Anpassungsmenü des Steuerelements auswählt.

CMFCOutlookBarTabCtrl::SetActiveTab

Legt die aktive Registerkarte fest. Die aktive Registerkarte ist die geöffnete Registerkarte mit sichtbaren Inhalten.

virtual BOOL SetActiveTab(int iTab);

Parameter

Itab
[in] Der nullbasierte Index einer registerkarte, die geöffnet werden soll.

Rückgabewert

Nonzero, wenn die angegebene Registerkarte erfolgreich geöffnet wurde; andernfalls 0.

Hinweise

Der visuelle Effekt der Einstellung der aktiven Registerkarte hängt davon ab, ob Sie animation aktiviert haben. Weitere Informationen finden Sie unter CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Legt die Rahmengröße des Outlook-Registerkartensteuerelements fest.

void SetBorderSize(int nBorderSize);

Parameter

nBorderSize
[in] Gibt die neue Rahmengröße in Pixel an.

Hinweise

Legt die neue Rahmengröße fest und berechnet das Outlook-Fensterlayout neu.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Legt die Ausrichtung der Textbeschriftungen auf den Registerkartenschaltflächen der Outlook-Leiste fest.

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

Parameter

uiAlign
[in] Gibt die Textausrichtung an.

bRedraw
[in] Wenn TRUE, wird das Outlook-Fenster neu gezeichnet.

Hinweise

Verwenden Sie diese Funktion, um die Textausrichtung für Seitenschaltflächen zu ändern.

uiAlign kann einer der folgenden Werte sein:

Konstante Bedeutung
TA_LEFT Linksbündige Ausrichtung
TA_CENTER Zentrieren der Ausrichtung
TA_RIGHT Rechtsbündig

Der Standardwert ist TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Legt die Bitmap fest, die die Symbole enthält, die unten auf der Outlook-Leiste im Outlook 2003-Modus angezeigt werden.

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

Parameter

uiID
[in] Gibt die Ressourcen-ID des zu ladenden Bilds an.

Cx
[in] Gibt die Breite eines Bilds in der Bildliste in Pixel an.

clrTransp
[in] Ein RGB-Wert, der die transparente Farbe angibt.

Rückgabewert

Gibt WAHR zurück, wenn dies erfolgreich ist; andernfalls wird FALSE zurückgegeben.

Hinweise

Verwenden Sie diese Funktion, um eine Bildliste anzufügen, deren Bilder im Microsoft Office 2003-Modus auf Symbolleistenschaltflächen angezeigt werden. Bildindizes sollten Seitenindizes entsprechen.

Diese Methode sollte nicht aufgerufen werden, wenn nicht im Microsoft Office 2003-Modus. Weitere Informationen finden Sie unter CMFCOutlookBar Class.

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Parameter

[in] nVisiblePageButtons

Hinweise

Siehe auch

Hierarchiediagramm
Klassen
CMFCBaseTabCtrl-Klasse
CMFCOutlookBar-Klasse
CMFCOutlookBarPane-Klasse