CMFCOutlookBarPane-Klasse
Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer 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
Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer 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
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