CMFCOutlookBarTabCtrl-Klasse
Ein Registerkarten-Steuerelement mit dem Aussehen des Navigationsbereichs in Microsoft Outlook verfügt. Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.
class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl
| Name | Beschreibung |
|---|---|
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl |
Der Standardkonstruktor. |
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl |
Destruktor. |
| 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 |
Legt fest, ob sich ein Punkt innerhalb des Registerkartenbereichs befindet. (Außerkraftsetzungen CMFCBaseTabCtrl::IsPtInTabArea.) |
CMFCOutlookBarTabCtrl::IsTabDetachable |
Legt fest, 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 |
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.
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);
Header: afxoutlookbartabctrl.h
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);
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.
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.
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);
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;
TRUE, wenn mehrere Schaltflächen vorhanden sind; andernfalls FALSE.
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.
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;
TRUE, wenn schaltflächen vorhanden sind, die zurzeit nicht sichtbar sind; andernfalls FALSE.
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.
Erstellt das Registerkartensteuerelement der Outlook-Leiste.
virtual BOOL Create(
const CRect& rect,
CWnd* pParentWnd,
UINT nID);
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.
Nonzero, wenn das Steuerelement erfolgreich erstellt wurde; andernfalls 0.
Normalerweise werden Registerkartensteuerelemente für die Outlook-Leiste erstellt, wenn die CMFCOutlookBar-Klasse die WM_CREATE Nachricht des Prozesses steuert.
Gibt an, ob die Animation, die während des Wechsels zwischen aktiven Registerkarten auftritt, aktiviert ist.
static void EnableAnimation(BOOL bEnable=TRUE);
bEnable
[in] Gibt an, ob die Animation aktiviert oder deaktiviert werden soll.
Rufen Sie diese Funktion auf, um animation zu aktivieren und zu deaktivieren. Wenn der Benutzer eine Registerkartenseite öffnet, wird die Beschriftung 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.
Gibt an, ob ein Benutzer die Textbeschriftungen auf den Registerkartenseitenschaltflächen der Outlook-Leiste ändern kann.
virtual void EnableInPlaceEdit(BOOL bEnable);
bEnable
Wenn WAHR, aktivieren Sie die direkte Bearbeitung der Textbeschriftung. Wenn FALSE, deaktivieren Sie die direkte Bearbeitung.
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.
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);
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.
Aktiviert die Anzeige der Bildlaufschaltflächen. Diese Methode wird vom Framework aufgerufen, wenn sich die aktive Registerkarte ändert, um die Bildlaufschaltflächen wiederherzustellen.
Gibt die Rahmengröße des Outlook-Registerkartensteuerelements zurück.
int GetBorderSize() const;
Die Rahmengröße in Pixel.
int GetVisiblePageButtons() const;
Gibt an, ob die Animation, die während des Wechsels zwischen aktiven Registerkarten auftritt, aktiviert ist.
static BOOL IsAnimation();
Nonzero, wenn die Animation aktiviert ist; andernfalls 0.
Rufen Sie die CMFCOutlookBarTabCtrl::EnableAnimation-Funktion auf, um animationen zu aktivieren oder zu deaktivieren.
Bestimmt, ob sich das Registerkartensteuerelement der Outlook-Leiste in einem Modus befindet, der Microsoft Outlook 2003 emuliert.
BOOL IsMode2003() const;
TRUE, wenn sich das Registerkartensteuerelement der Outlook-Leiste im Outlook 2003-Modus befindet; andernfalls FALSE;
Dieser Wert wird von CMFCOutlookBar::SetMode2003 festgelegt.
Vom Framework aufgerufen, um die Anzahl der sichtbaren Registerkartenseitenschaltflächen zu verringern.
virtual void OnShowFewerPageButtons();
Diese Methode passt die Anzahl der sichtbaren Seitenregisterschaltflächen an, wenn die Größe des Steuerelements geändert wird.
Wird vom Framework aufgerufen, um die Anzahl der sichtbaren Registerkartenseitenschaltflächen zu erhöhen.
virtual void OnShowMorePageButtons();
Diese Methode passt die Anzahl der Registerkartenseitenschaltflächen an, die angezeigt werden, wenn die Größe des Steuerelements geändert wird.
Zeigt das Dialogfeld "Navigationsbereichsoptionen " an.
virtual void OnShowOptions();
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.
Legt die aktive Registerkarte fest. Die aktive Registerkarte ist die geöffnete Registerkarte mit sichtbaren Inhalten.
virtual BOOL SetActiveTab(int iTab);
iTab
[in] Der nullbasierte Index einer registerkarte, die geöffnet werden soll.
Nonzero, wenn die angegebene Registerkarte erfolgreich geöffnet wurde; andernfalls 0.
Der visuelle Effekt der Einstellung der aktiven Registerkarte hängt davon ab, ob Sie animation aktiviert haben. Weitere Informationen finden Sie unter CMFCOutlookBarTabCtrl::EnableAnimation.
Legt die Rahmengröße des Outlook-Registerkartensteuerelements fest.
void SetBorderSize(int nBorderSize);
nBorderSize
[in] Gibt die neue Rahmengröße in Pixel an.
Legt die neue Rahmengröße fest und berechnet das Outlook-Fensterlayout neu.
Legt die Ausrichtung der Textbeschriftungen auf den Registerkartenschaltflächen der Outlook-Leiste fest.
void SetPageButtonTextAlign(
UINT uiAlign,
BOOL bRedraw=TRUE);
uiAlign
[in] Gibt die Textausrichtung an.
bRedraw
[in] Wenn TRUE, wird das Outlook-Fenster neu gezeichnet.
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.
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));
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.
Gibt WAHR zurück, wenn dies erfolgreich ist; andernfalls wird FALSE zurückgegeben.
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.
void SetVisiblePageButtons(int nVisiblePageButtons);
[in] nVisiblePageButtons
Hierarchiediagramm
Klassen
CMFCBaseTabCtrl-Klasse
CMFCOutlookBar-Klasse
CMFCOutlookBarPane-Klasse