CMFCRibbonStatusBar-Klasse
Die CMFCRibbonStatusBar Klasse implementiert ein Statusleisten-Steuerelement, das Menübandelemente anzeigen kann.
Syntax
class CMFCRibbonStatusBar : public CMFCRibbonBar
Member
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CMFCRibbonStatusBar::AddDynamicElement | Fügt der Statusleiste des Menübands ein dynamisches Element hinzu. |
| CMFCRibbonStatusBar::AddElement | Fügt der Statusleiste des Menübands ein neues Menübandelement hinzu. |
| CMFCRibbonStatusBar::AddExtendedElement | Fügt dem erweiterten Bereich der Menüband-Statusleiste ein Menübandelement hinzu. |
| CMFCRibbonStatusBar::AddSeparator | Fügt der Statusleiste des Menübands ein Trennzeichen hinzu. |
| CMFCRibbonStatusBar::Create | Erstellt eine Menüband-Statusleiste. |
| CMFCRibbonStatusBar::CreateEx | Erstellt eine Statusleiste des Menübands mit einer erweiterten Formatvorlage. |
| CMFCRibbonStatusBar::FindByID | |
| CMFCRibbonStatusBar::FindElement | Gibt einen Zeiger auf das Element zurück, das die angegebene Befehls-ID aufweist. |
| CMFCRibbonStatusBar::GetCount | Gibt die Anzahl der Elemente zurück, die sich im Hauptbereich der Statusleiste des Menübands befinden. |
| CMFCRibbonStatusBar::GetElement | Gibt einen Zeiger auf das Element zurück, das sich an einem angegebenen Index befindet. |
| CMFCRibbonStatusBar::GetExCount | Gibt die Anzahl der Elemente zurück, die sich im erweiterten Bereich der Menübandstatusleiste befinden. |
| CMFCRibbonStatusBar::GetExElement | Gibt einen Zeiger auf das Element zurück, das sich an einem angegebenen Index im erweiterten Bereich des Status-Menübands befindet. |
| CMFCRibbonStatusBar::GetExtendedArea | |
| CMFCRibbonStatusBar::GetSpace | |
| CMFCRibbonStatusBar::IsBottomFrame | |
| CMFCRibbonStatusBar::IsExtendedElement | |
| CMFCRibbonStatusBar::IsInformationMode | Bestimmt, ob der Informationsmodus für die Statusleiste des Menübands aktiviert ist. |
| CMFCRibbonStatusBar::RecalcLayout | (Außerkraftsetzungen CMFCRibbonBar::RecalcLayout.) |
| CMFCRibbonStatusBar::RemoveAll | Entfernt alle Elemente aus der Statusleiste des Menübands. |
| CMFCRibbonStatusBar::RemoveElement | Entfernt das Element, das über eine angegebene Befehls-ID verfügt, aus der Statusleiste des Menübands. |
| CMFCRibbonStatusBar::SetInformation | Aktiviert oder deaktiviert den Informationsmodus für die Statusleiste des Menübands. |
Geschützte Methoden
| Name | Beschreibung |
|---|---|
| CMFCRibbonStatusBar::OnDrawInformation | Zeigt die Informationszeichenfolge an, die auf der Statusleiste des Menübands angezeigt wird, wenn der Informationsmodus aktiviert ist. |
Hinweise
Benutzer können die Sichtbarkeit von Menübandelementen auf einer Menüband-Statusleiste mithilfe des integrierten Kontextmenüs für die Menüband-Statusleiste ändern. Sie können Elemente dynamisch hinzufügen oder entfernen.
Eine Menüband-Statusleiste verfügt über zwei Bereiche: einen Hauptbereich und einen erweiterten Bereich. Der erweiterte Bereich wird auf der rechten Seite der Statusleiste des Menübands angezeigt und in einer anderen Farbe angezeigt als der Hauptbereich.
In der Regel zeigt der Hauptbereich der Statusleiste Statusbenachrichtigungen an, und im erweiterten Bereich werden Ansichtssteuerelemente angezeigt. Der erweiterte Bereich bleibt so lange wie möglich sichtbar, wenn der Benutzer die Größe der Menübandstatusleiste ändert.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung verschiedener Methoden in der CMFCRibbonStatusBar -Klasse. Das Beispiel zeigt, wie Sie der Statusleiste des Menübands ein neues Menübandelement hinzufügen, dem erweiterten Bereich der Menübandstatusleiste ein Menübandelement hinzufügen, ein Trennzeichen hinzufügen und den regulären Modus für die Menübandstatusleiste aktivieren.
// CMFCRibbonStatusBar m_wndStatusBar
m_wndStatusBar.AddElement(rsbp, strTitlePane1);
m_wndStatusBar.AddExtendedElement(new CMFCRibbonStatusBarPane(ID_STATUSBAR_PANE2, strTitlePane2, TRUE),
strTitlePane2);
m_wndStatusBar.AddSeparator();
m_wndStatusBar.SetInformation(NULL);
Vererbungshierarchie
Anforderungen
Kopfzeile: afxribbonstatusbar.h
CMFCRibbonStatusBar::AddDynamicElement
Fügt der Statusleiste des Menübands ein dynamisches Element hinzu.
void AddDynamicElement(CMFCRibbonBaseElement* pElement);
Parameter
pElement
[in] Ein Zeiger auf ein dynamisches Element.
Hinweise
Im Gegensatz zu regulären Elementen können dynamische Elemente nicht angepasst werden, und das Menü "Anpassen" der Statusleiste zeigt sie nicht an.
CMFCRibbonStatusBar::AddElement
Fügt der Statusleiste des Menübands ein neues Menübandelement hinzu.
void AddElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Parameter
pElement
[in] Ein Zeiger auf das hinzugefügte Element.
lpszLabel
[in] Eine Textbezeichnung des Elements.
bIsVisible
[in] TRUE, wenn Sie das Element als sichtbar hinzufügen möchten, FALSE, wenn Sie das Element als ausgeblendet hinzufügen möchten.
CMFCRibbonStatusBar::AddExtendedElement
Fügt dem erweiterten Bereich der Menüband-Statusleiste ein Menübandelement hinzu.
void AddExtendedElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Parameter
pElement
[in] Ein Zeiger auf das hinzugefügte Element.
lpszLabel
[in] Die Textbezeichnung des Elements.
bIsVisible
[in] TRUE, wenn Sie das Element als sichtbar hinzufügen möchten, FALSE, wenn Sie das Element als ausgeblendet hinzufügen möchten.
Hinweise
Der erweiterte Bereich befindet sich rechts vom Statusleisten-Steuerelement.
CMFCRibbonStatusBar::AddSeparator
Fügt der Statusleiste des Menübands ein Trennzeichen hinzu.
void AddSeparator();
Hinweise
Das Framework fügt nach der Methode CMFCRibbonStatusBar::AddElement ein Trennzeichen hinzu. fügt das letzte Element ein.
CMFCRibbonStatusBar::Create
Erstellt eine Menüband-Statusleiste.
BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Parameter
pParentWnd
[in] Ein Zeiger auf das übergeordnete Fenster.
dwStyle
[in] Eine logische OR-Kombination aus Steuerelementformatvorlagen.
Nid
[in] Die Steuerelement-ID der Statusleiste.
Rückgabewert
TRUE, wenn die Statusleiste erfolgreich erstellt wird, andernfalls FALSE.
CMFCRibbonStatusBar::CreateEx
Erstellt eine Statusleiste des Menübands, die eine erweiterte Formatvorlage aufweist.
BOOL CreateEx(
CWnd* pParentWnd,
DWORD dwCtrlStyle=0,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Parameter
pParentWnd
Ein Zeiger auf das übergeordnete Fenster.
dwCtrlStyle
Eine logische ODER-Kombination aus zusätzlichen Formatvorlagen zum Erstellen des Statusleistenobjekts.
dwStyle
Die Steuerelementart der Statusleiste.
Nid
Die Steuerelement-ID der Statusleiste.
Rückgabewert
TRUE, wenn die Statusleiste erfolgreich erstellt wird, andernfalls FALSE.
CMFCRibbonStatusBar::FindByID
Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.
CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);
Parameter
[in] uiCmdID
[in] BOOL
Rückgabewert
Bemerkungen
CMFCRibbonStatusBar::FindElement
Gibt einen Zeiger auf das Element zurück, das die angegebene Befehls-ID aufweist.
CMFCRibbonBaseElement* FindElement(UINT uiID);
Parameter
uiID
[in] Die ID des Elements.
Rückgabewert
Ein Zeiger auf das Element mit der angegebenen Befehls-ID. NULL, wenn kein solches Element vorhanden ist.
CMFCRibbonStatusBar::GetCount
Gibt die Anzahl der Elemente zurück, die sich im Hauptbereich der Statusleiste des Menübands befinden.
int GetCount() const;
Rückgabewert
Die Anzahl der Elemente, die sich im Hauptbereich der Statusleiste des Menübands befinden.
CMFCRibbonStatusBar::GetElement
Gibt einen Zeiger auf das Element zurück, das sich an einem angegebenen Index befindet.
CMFCRibbonBaseElement* GetElement(int nIndex);
Parameter
nIndex
[in] Gibt einen nullbasierten Index eines Elements an, das sich im Hauptbereich des Statusleisten-Steuerelements befindet.
Rückgabewert
Ein Zeiger auf das Element, das sich am angegebenen Index befindet. NULL, wenn der Index negativ ist oder die Anzahl der Elemente in der Statusleiste überschreitet.
Hinweise
CMFCRibbonStatusBar::GetExCount
Gibt die Anzahl der Elemente zurück, die sich im erweiterten Bereich der Menübandstatusleiste befinden.
int GetExCount() const;
Rückgabewert
Die Anzahl der Elemente, die sich im erweiterten Bereich der Menübandstatusleiste befinden.
CMFCRibbonStatusBar::GetExElement
Gibt einen Zeiger auf das Element zurück, das sich an einem angegebenen Index im erweiterten Bereich des Status-Menübands befindet. Der erweiterte Bereich befindet sich rechts vom Statusleisten-Steuerelement.
CMFCRibbonBaseElement* GetExElement(int nIndex);
Parameter
nIndex
[in] Gibt den nullbasierten Index eines Elements an, das sich im erweiterten Bereich des Statusleisten-Steuerelements befindet.
Rückgabewert
Ein Zeiger auf das Element, das sich an einem angegebenen Index im erweiterten Bereich des Status-Menübands befindet. NULL, wenn nIndex negativ ist oder die Anzahl der Elemente im erweiterten Bereich der Menübandstatusleiste überschreitet.
Hinweise
CMFCRibbonStatusBar::GetExtendedArea
Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.
virtual BOOL GetExtendedArea(CRect& rect) const;
Parameter
[in] rect
Rückgabewert
Bemerkungen
CMFCRibbonStatusBar::GetSpace
Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.
int GetSpace() const;
Rückgabewert
Bemerkungen
CMFCRibbonStatusBar::IsBottomFrame
Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.
BOOL IsBottomFrame() const;
Rückgabewert
Bemerkungen
CMFCRibbonStatusBar::IsExtendedElement
Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.
BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;
Parameter
[in] pElement
Rückgabewert
Bemerkungen
CMFCRibbonStatusBar::IsInformationMode
Bestimmt, ob der Informationsmodus für die Statusleiste des Menübands aktiviert ist.
BOOL IsInformationMode() const;
Rückgabewert
TRUE, wenn die Statusleiste im Informationsmodus funktionieren kann; andernfalls FALSE.
Hinweise
Im Informationsmodus blendet die Statusleiste alle regulären Bereiche aus und zeigt eine Meldungszeichenfolge an.
CMFCRibbonStatusBar::OnDrawInformation
Zeigt die Zeichenfolge an, die auf der Statusleiste des Menübands angezeigt wird, wenn der Informationsmodus aktiviert ist.
virtual void OnDrawInformation(
CDC* pDC,
CString& strInfo,
CRect rectInfo);
Parameter
pDC
[in] Ein Zeiger auf einen Gerätekontext.
strInfo
[in] Die Informationszeichenfolge.
rectInfo
[in] Das umgebende Rechteck.
Hinweise
Überschreiben Sie diese Methode in einer abgeleiteten Klasse, wenn Sie die Darstellung der Informationszeichenfolge auf der Statusleiste anpassen möchten. Verwenden Sie die CMFCRibbonStatusBar::SetInformation-Methode , um die Statusleiste im Informationsmodus zu platzieren. In diesem Modus blendet die Statusleiste alle Bereiche aus und zeigt die durch strInfo angegebene Informationszeichenfolge an.
CMFCRibbonStatusBar::RecalcLayout
Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.
virtual void RecalcLayout();
Hinweise
CMFCRibbonStatusBar::RemoveAll
Entfernt alle Elemente aus der Statusleiste des Menübands.
void RemoveAll();
CMFCRibbonStatusBar::RemoveElement
Entfernt das Element, das über eine angegebene Befehls-ID verfügt, aus der Statusleiste des Menübands.
BOOL RemoveElement(UINT uiID);
Parameter
uiID
[in] Die ID des Elements, das aus der Statusleiste entfernt werden soll.
Rückgabewert
TRUE, wenn ein Element mit der angegebenen UIID entfernt wird. Andernfalls FALSE.
CMFCRibbonStatusBar::SetInformation
Aktiviert oder deaktiviert den Informationsmodus für die Statusleiste des Menübands.
void SetInformation(LPCTSTR lpszInfo);
Parameter
lpszInfo
[in] Die Informationszeichenfolge.
Hinweise
Verwenden Sie diese Methode, um die Statusleiste im Informationsmodus zu platzieren. In diesem Modus blendet die Statusleiste alle Bereiche aus und zeigt die durch lpszInfo angegebene Informationszeichenfolge an.
Wenn lpszInfo NULL ist, wird die Statusleiste in den regulären Modus zurückgesetzt.
Siehe auch
Hierarchiediagramm
Klassen
CMFCRibbonBar-Klasse
CMFCRibbonBaseElement-Klasse
CMFCRibbonBar-Klasse