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
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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für