CMFCOutlookBarPane-Klasse

Artikel
10/12/2023

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Ein von DER CMFCToolBar-Klasse abgeleitetes Steuerelement, das in eine Outlook-Leiste ( CMFCOutlookBar Class) eingefügt werden kann. Der Outlook-Leistenbereich enthält eine Spalte mit großen Schaltflächen. Der Benutzer kann einen Bildlauf durchführen, um die Liste der Schaltflächen nach oben bzw. unten zu verschieben, wenn sie größer ist als der Bereich. Wenn der Benutzer einen Outlook-Leistenbereich von der Outlook-Leiste trennt, ist er frei positionierbar oder kann im Hauptrahmenfenster andocken.

Syntax

class CMFCOutlookBarPane : public CMFCToolBar

Member

Öffentliche Konstruktoren

Name	Beschreibung
`CMFCOutlookBarPane::CMFCOutlookBarPane`	Der Standardkonstruktor.
`CMFCOutlookBarPane::~CMFCOutlookBarPane`	Destruktor.

Öffentliche Methoden

Name	Beschreibung
CMFCOutlookBarPane::AddButton	Fügt dem Outlook-Leistenbereich eine Schaltfläche hinzu.
CMFCOutlookBarPane::CanBeAttached	Bestimmt, ob der Bereich an einen anderen Bereich oder rahmenfenster angedockt werden kann. (Außerkraftsetzungen CBasePane::CanBeAttached.)
`CMFCOutlookBarPane::CanBeRestored`	Bestimmt, ob das System eine Symbolleiste nach der Anpassung in den ursprünglichen Zustand wiederherstellen kann. (Außerkraftsetzungen CMFCToolBar::CanBeRestored.)
CMFCOutlookBarPane::ClearAll	Gibt die Ressourcen frei, die von den Bildern im Outlook-Leistenbereich verwendet werden.
CMFCOutlookBarPane::Create	Erstellt den Outlook-Leistenbereich.
`CMFCOutlookBarPane::CreateObject`	Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen.
`CMFCOutlookBarPane::Dock`	Vom Framework aufgerufen, um den Outlook-Leistenbereich anzudocken. (Überschreibt `CPane::Dock`.)
CMFCOutlookBarPane::EnablePageScrollMode	Gibt an, ob die Bildlaufpfeile im Outlook-Leistenbereich die Liste der Schaltflächen nach Seite oder nach Schaltfläche voranbringen.
CMFCOutlookBarPane::GetRegularColor	Gibt die normale Textfarbe (nicht ausgewählt) des Outlook-Leistenbereichs zurück.
`CMFCOutlookBarPane::GetThisClass`	Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCOutlookBarPane::IsBackgroundTexture	Bestimmt, ob ein Hintergrundbild für den Outlook-Leistenbereich geladen ist.
`CMFCOutlookBarPane::IsChangeState`	Bestimmt, ob ein unverankerter Bereich angedockt werden kann. (Überschreibt `CPane::IsChangeState`.)
CMFCOutlookBarPane::IsDrawShadedHighlight	Bestimmt, ob der Schaltflächenrahmen schattiert wird, wenn eine Schaltfläche hervorgehoben und ein Hintergrundbild angezeigt wird.
`CMFCOutlookBarPane::OnBeforeFloat`	Wird vom Framework aufgerufen, wenn ein Bereich in der Zeit zum Gleiten ist. (Außerkraftsetzungen CPane::OnBeforeFloat.)
CMFCOutlookBarPane::RemoveButton	Entfernt die Schaltfläche mit einer angegebenen Befehls-ID.
`CMFCOutlookBarPane::RestoreOriginalstate`	Stellt den originalen Zustand einer Symbolleiste wieder her. (Außerkraftsetzungen CMFCToolBar::RestoreOriginalState.)
CMFCOutlookBarPane::SetBackColor	Legt die Hintergrundfarbe fest.
CMFCOutlookBarPane::SetBackImage	Legt das Hintergrundbild fest.
CMFCOutlookBarPane::SetDefaultState	Setzt den Outlook-Leistenbereich auf den ursprünglichen Satz von Schaltflächen zurück.
CMFCOutlookBarPane::SetExtraSpace	Legt die Anzahl der Pixel des Abstands fest, die um Schaltflächen im Outlook-Leistenbereich verwendet werden.
CMFCOutlookBarPane::SetTextColor	Legt die Farben normaler und hervorgehobener Text im Outlook-Leistenbereich fest.
CMFCOutlookBarPane::SetTransparentColor	Legt die transparente Farbe für den Outlook-Leistenbereich fest.
`CMFCOutlookBarPane::SmartUpdate`	Wird intern verwendet, um die Outlook-Leiste zu aktualisieren. (Überschreibt `CMFCToolBar::SmartUpdate`.)

Geschützte Methoden

Name	Beschreibung
CMFCOutlookBarPane::EnableContextMenuItems	Gibt an, welche Kontextmenüelemente im Anpassungsmodus angezeigt werden.
CMFCOutlookBarPane::RemoveAllButtons	Entfernt alle Schaltflächen aus dem Outlook-Leistenbereich. (Außerkraftsetzungen CMFCToolBar::RemoveAllButtons.)

Hinweise

Informationen zum Implementieren einer Outlook-Leiste finden Sie unter CMFCOutlookBar Class.

Ein Beispiel für eine Outlook-Leiste finden Sie im OutlookDemo-Beispielprojekt.

Beispiel

Im folgenden Beispiel wird die Verwendung verschiedener Methoden der CMFCOutlookBarPane Klasse veranschaulicht. Das Beispiel zeigt, wie Sie einen Outlook-Leistenbereich erstellen, den Seitenlaufmodus aktivieren, andocken und die Hintergrundfarbe der Outlook-Leiste festlegen. Dieser Codeausschnitt ist Teil des Outlook Multi Views-Beispiels.

CMFCOutlookBarPane m_wndShortcutsPane1;

CImageList images;
images.Create(IDB_SHORTCUTS, 32, 0, RGB(255, 0, 255));

// Create first page:
m_wndShortcutsPane1.Create(&m_wndShortcutsBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_SHORTCUTS_PANE_1);
// The this pointer points to a CMainFrame class which extends the CFrameWnd class
m_wndShortcutsPane1.SetOwner(this);
m_wndShortcutsPane1.EnableTextLabels();
m_wndShortcutsPane1.EnableDocking(CBRS_ALIGN_ANY);
m_wndShortcutsPane1.EnablePageScrollMode();
m_wndShortcutsPane1.SetBackColor(RGB(0, 255, 0));

m_wndShortcutsPane1.AddButton(images.ExtractIcon(0), _T("View 1"), ID_SHORTCUT_1);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(1), _T("View 2"), ID_SHORTCUT_2);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(2), _T("View 3"), ID_SHORTCUT_3);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(3), _T("View 4"), ID_SHORTCUT_4);

Vererbungshierarchie

Anforderungen

Header: afxoutlookbarpane.h

CMFCOutlookBarPane::AddButton

Fügt dem Outlook-Leistenbereich eine Schaltfläche hinzu.

BOOL AddButton(
    UINT uiImage,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    UINT uiImage,
    UINT uiLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    LPCTSTR szBmpFileName,
    LPCTSTR szLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HBITMAP hBmp,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HICON hIcon,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1,
    BOOL bAlphaBlend=FALSE);

Parameter

uiImage
[in] Gibt den Ressourcenbezeichner einer Bitmap an.

lpszLabel
[in] Gibt den Text der Schaltfläche an.

iIdCommand
[in] Gibt die ID des Schaltflächensteuerelements an.

iInsertAt
[in] Gibt den nullbasierten Index auf der Seite der Outlook-Leiste an, an der die Schaltfläche eingefügt werden soll.

uiLabel
[in] Eine Zeichenfolgenressourcen-ID.

szBmpFileName
[in] Gibt den Namen der zu ladenden Datenträgerimagedatei an.

szLabel
[in] Gibt den Text der Schaltfläche an.

hBmp
[in] Ein Handle für die Bitmap einer Schaltfläche.

hIcon
[in] Ein Ziehpunkt für das Symbol einer Schaltfläche.

Rückgabewert

TRUE, wenn eine Schaltfläche erfolgreich hinzugefügt wurde; andernfalls FALSE.

Hinweise

Verwenden Sie diese Methode, um eine neue Schaltfläche in die Seite einer Outlook-Leiste einzufügen. Das Bild der Schaltfläche kann entweder aus den Anwendungsressourcen oder aus einer Datenträgerdatei geladen werden.

Wenn die durch uiPageID angegebene Seiten-ID -1 lautet, wird die Schaltfläche in die erste Seite eingefügt.

Wenn der durch iInsertAt angegebene Index -1 ist, wird die Schaltfläche am Ende der Seite hinzugefügt.

CMFCOutlookBarPane::CanBeAttached

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

virtual BOOL CanBeAttached() const;

Rückgabewert

Bemerkungen

CMFCOutlookBarPane::ClearAll

Gibt die Ressourcen frei, die von den Bildern im Outlook-Leistenbereich verwendet werden.

void ClearAll();

Hinweise

Diese Methode ruft direkt CMFCToolBarImages::Clear auf, die für die Bilder aufgerufen wird, die vom Outlook-Leistenbereich verwendet werden.

CMFCOutlookBarPane::Create

Erstellt den Outlook-Leistenbereich.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT uiID=(UINT)-1,
    DWORD dwControlBarStyle=0);

Parameter

pParentWnd
[in] Gibt das übergeordnete Fenster des Outlook-Leistenbereich-Steuerelements an. Darf nicht NULL sein.

dwStyle
[in] Die Fensterformatvorlage. Eine Liste der Fensterformatvorlagen finden Sie unter "Fensterformatvorlagen".

uiID
[in] Die Steuerelement-ID. Muss eindeutig sein, um das Speichern des Zustands des Steuerelements zu aktivieren.

dwControlBarStyle
[in] Gibt spezielle Formatvorlagen an, die das Verhalten des Outlook-Leistenbereich-Steuerelements definieren, wenn es von der Outlook-Leiste getrennt wird.

Rückgabewert

TRUE, wenn die Methode erfolgreich war; andernfalls FALSE.

Hinweise

Um ein CMFCOutlookBarPane Objekt zu erstellen, rufen Sie zuerst den Konstruktor auf, und rufen Sie Createdann auf, wodurch das Steuerelement für den Fensterbereich von Outlook erstellt und an das CMFCOutlookBarPane Objekt angefügt wird.

Weitere Informationen dwControlBarStyle finden Sie unter CBasePane::CreateEx.

CMFCOutlookBarPane::EnableContextMenuItems

Gibt an, welche Kontextmenüelemente im Anpassungsmodus angezeigt werden.

virtual BOOL EnableContextMenuItems(
    CMFCToolBarButton* pButton,
    CMenu* pPopup);

Parameter

pButton
[in] Ein Zeiger auf eine Symbolleistenschaltfläche, auf die ein Benutzer geklickt hat.

pPopup
[in] Ein Zeiger auf das Kontextmenü.

Rückgabewert

Gibt TRUE zurück, wenn das Kontextmenü angezeigt werden soll; andernfalls FALSE.

Hinweise

Überschreiben Sie diese Methode, um das Framework-Standard-Kontextmenü zu ändern, das vom Framework im Anpassungsmodus angezeigt wird.

Die Standardimplementierung überprüft den Anpassungsmodus ( CMFCToolBar::IsCustomizeMode) und wenn sie auf TRUE festgelegt ist, werden alle Kontextmenüelemente außer "Löschen" deaktiviert. Anschließend übergibt es einfach die Eingabeparameter an CMFCToolBar::EnableContextMenuItems.

Hinweis

Kontextmenü ist ein Synonym für Kontextmenüs.

CMFCOutlookBarPane::EnablePageScrollMode

Gibt an, ob die Bildlaufpfeile im Outlook-Leistenbereich die Liste der Schaltflächenseite nach Seite oder Schaltfläche nach Schaltfläche voranbringen.

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

Parameter

bPageScroll
[in] Wenn TRUE, aktivieren Sie den Seitenlaufmodus. Wenn FALSCH, deaktivieren Sie den Seitenlaufmodus.

CMFCOutlookBarPane::GetRegularColor

Gibt die normale Textfarbe (d. h. nicht ausgewählt) des Outlook-Leistenbereichs zurück.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Rückgabewert

Die aktuelle Textfarbe als RGB-Farbwert.

Hinweise

Verwenden Sie CMFCOutlookBarPane::SetTextColor , um die aktuelle (normale und ausgewählte) Textfarbe der Outlook-Leiste festzulegen. Sie können die Standardtextfarbe abrufen, indem Sie die GetSysColor-Funktion mit dem COLOR_WINDOW Index aufrufen.

CMFCOutlookBarPane::IsBackgroundTexture

Bestimmt, ob ein Hintergrundbild für den Outlook-Leistenbereich geladen ist.

BOOL IsBackgroundTexture() const;

Rückgabewert

TRUE, wenn hintergrundbild angezeigt werden soll; andernfalls FALSE.

Hinweise

Sie können ein Hintergrundbild hinzufügen, indem Sie CMFCOutlookBarPane::SetBackImage-Funktion aufrufen.

Wenn kein Hintergrundbild vorhanden ist, wird der Hintergrund mit einer farbe gezeichnet, die mithilfe von CMFCOutlookBarPane::SetBackColor angegeben wird.

CMFCOutlookBarPane::IsDrawShadedHighlight

Bestimmt, ob der Schaltflächenrahmen schattiert wird, wenn eine Schaltfläche hervorgehoben und ein Hintergrundbild angezeigt wird.

BOOL IsDrawShadedHighlight() const;

Rückgabewert

TRUE, wenn die Rahmen der Schaltfläche schattiert werden; andernfalls FALSE.

CMFCOutlookBarPane::RemoveAllButtons

Entfernt alle Schaltflächen aus dem Outlook-Leistenbereich.

virtual void RemoveAllButtons();

CMFCOutlookBarPane::RemoveButton

Entfernt die Schaltfläche mit einer angegebenen Befehls-ID.

BOOL RemoveButton(UINT iIdCommand);

Parameter

iIdCommand
[in] Gibt die Befehls-ID einer zu entfernenden Schaltfläche an.

Rückgabewert

TRUE, wenn die Schaltfläche erfolgreich entfernt wurde; FALSE, wenn die angegebene Befehls-ID ungültig ist.

CMFCOutlookBarPane::SetBackColor

Legt die Hintergrundfarbe der Outlook-Leiste fest.

void SetBackColor(COLORREF color);

Parameter

color
[in] Gibt die neue Hintergrundfarbe an.

Hinweise

Rufen Sie diese Funktion auf, um die aktuelle Hintergrundfarbe für die Outlook-Leiste festzulegen. Die Hintergrundfarbe wird nur verwendet, wenn kein Hintergrundbild vorhanden ist.

CMFCOutlookBarPane::SetBackImage

Legt das Hintergrundbild fest.

void SetBackImage(UINT uiImageID);

Parameter

uiImageID
[in] Gibt die Bildressourcen-ID an.

Hinweise

Rufen Sie diese Methode auf, um das Hintergrundbild der Outlook-Leiste festzulegen. Die Liste der Hintergrundbilder wird vom eingebetteten CMFCToolBarImages-Klassenobjekt verwaltet.

CMFCOutlookBarPane::SetDefaultState

Setzt den Outlook-Leistenbereich auf den ursprünglichen Satz von Schaltflächen zurück.

void SetDefaultState();

Hinweise

Mit dieser Methode werden die Outlook-Leistenschaltflächen auf den ursprünglichen Satz wiederhergestellt. Diese Methode ähnelt CMFCOutlookBarPane::RestoreOriginalstate, mit der Ausnahme, dass sie keine Neuansicht des Outlook-Leistenbereichs auslöst.

CMFCOutlookBarPane::SetExtraSpace

Legt die Anzahl der Pixel des Abstands fest, die um Schaltflächen im Outlook-Leistenbereich verwendet werden.

void SetExtraSpace()

CMFCOutlookBarPane::SetTextColor

Legt die Farben normaler und hervorgehobener Text im Outlook-Leistenbereich fest.

void SetTextColor(
    COLORREF clrRegText,
    COLORREF clrSelText=0);

Parameter

clrRegText
[in] Gibt die neue Farbe für nicht markierten Text an.

clrSelText
[in] Gibt die neue Farbe für markierten Text an.

CMFCOutlookBarPane::SetTransparentColor

Legt die transparente Farbe für den Outlook-Leistenbereich fest.

void SetTransparentColor(COLORREF color);

Parameter

color
Gibt die neue transparente Farbe an.

Hinweise

Die transparente Farbe ist erforderlich, um transparente Bilder anzuzeigen. Jedes Vorkommen dieser Farbe in einem Bild wird stattdessen mit der Hintergrundfarbe gezeichnet. Es gibt keine Mischung aus Hintergrund- und Vordergrundbildern.

Siehe auch

Hierarchiediagramm
Klassen
CMFCToolBar-Klasse
CMFCOutlookBar-Klasse
CMFCOutlookBarTabCtrl-Klasse

Freigeben über

CMFCOutlookBarPane-Klasse

Syntax

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Geschützte Methoden

Hinweise

Beispiel

Vererbungshierarchie

Anforderungen

CMFCOutlookBarPane::AddButton

Parameter

Rückgabewert

Hinweise

CMFCOutlookBarPane::CanBeAttached

Rückgabewert

Bemerkungen

CMFCOutlookBarPane::ClearAll

Hinweise

CMFCOutlookBarPane::Create

Parameter

Rückgabewert

Hinweise

CMFCOutlookBarPane::EnableContextMenuItems

Parameter

Rückgabewert

Hinweise

CMFCOutlookBarPane::EnablePageScrollMode

Parameter

CMFCOutlookBarPane::GetRegularColor

Rückgabewert

Hinweise

CMFCOutlookBarPane::IsBackgroundTexture

Rückgabewert

Hinweise

CMFCOutlookBarPane::IsDrawShadedHighlight

Rückgabewert

CMFCOutlookBarPane::RemoveAllButtons

CMFCOutlookBarPane::RemoveButton

Parameter

Rückgabewert

CMFCOutlookBarPane::SetBackColor

Parameter

Hinweise

CMFCOutlookBarPane::SetBackImage

Parameter

Hinweise

CMFCOutlookBarPane::SetDefaultState

Hinweise

CMFCOutlookBarPane::SetExtraSpace

CMFCOutlookBarPane::SetTextColor

Parameter

CMFCOutlookBarPane::SetTransparentColor

Parameter

Hinweise

Siehe auch

Feedback

Zusätzliche Ressourcen