CMFCRibbonSeparator-Klasse
Implementiert das Menübandtrennzeichen.
Syntax
class CMFCRibbonSeparator : public CMFCRibbonBaseElement
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CMFCRibbonSeparator::CMFCRibbonSeparator | Erstellt ein CMFCRibbonSeparator-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CMFCRibbonSeparator::AddToListBox | Fügt der Befehlsliste im Dialogfeld "Anpassen " ein Trennzeichen hinzu. (Außerkraftsetzungen CMFCRibbonBaseElement::AddToListBox.) |
CMFCRibbonSeparator::CreateObject |
Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen. |
CMFCRibbonSeparator::GetThisClass |
Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist. |
Geschützte Methoden
| Name | Beschreibung |
|---|---|
| CMFCRibbonSeparator::CopyFrom | Eine Kopiermethode, die membervariablen eines Trennzeichens aus einem anderen Objekt festlegt. |
| CMFCRibbonSeparator::GetRegularSize | Gibt die Größe eines Trennzeichens zurück. |
| CMFCRibbonSeparator::IsSeparator | Gibt an, ob es sich um ein Trennzeichen handelt. |
| CMFCRibbonSeparator::IsTabStop | Gibt an, ob es sich um einen Tabstopp handelt. |
| CMFCRibbonSeparator::OnDraw | Vom System aufgerufen, um das Trennzeichen entweder im Menüband oder auf der Symbolleiste für den Schnellzugriff zu zeichnen. |
| CMFCRibbonSeparator::OnDrawOnList | Wird vom System aufgerufen, um das Trennzeichen in der Befehlsliste zu zeichnen. |
Hinweise
Ein Menübandtrennzeichen ist eine vertikale oder horizontale Linie, die Menübandelemente logisch trennt. Ein Trennzeichen kann im Menüband-Steuerelement, dem Hauptanwendungsmenü, der Statusleiste des Menübands und der Symbolleiste für den Schnellzugriff gezeichnet werden.
Um ein Trennzeichen in Ihrer Anwendung zu verwenden, erstellen Sie das neue Objekt, und fügen Sie es wie hier gezeigt zum Hauptmenü der Anwendung hinzu:
CMFCRibbonMainPanel* pMainPanel = m_wndRibbonBar.AddMainCategory(_T("Main Menu"),
IDB_FILESMALL,
IDB_FILELARGE);
...
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));
Rufen Sie CMFCRibbonPanel::AddSeparator auf, um Trennzeichen zu Menübandbereichen hinzuzufügen. Die Trennzeichen werden intern von der AddSeparator Methode zugewiesen und hinzugefügt.
Vererbungshierarchie
Anforderungen
Header: afxbaseribbonelement.h
CMFCRibbonSeparator::AddToListBox
Fügt der Befehlsliste im Dialogfeld "Anpassen " ein Trennzeichen hinzu.
virtual int AddToListBox(
CMFCRibbonCommandsListBox* pWndListBox,
BOOL bDeep);
Parameter
pWndListBox
[in] Ein Zeiger auf die Befehlsliste, in der das Trennzeichen hinzugefügt wird.
bDeep
[in] Ignoriert.
Rückgabewert
Nullbasierter Index zur Zeichenfolge im durch pWndListBox angegebenen Listenfeld.
CMFCRibbonSeparator::CMFCRibbonSeparator
Erstellt ein CMFCRibbonSeparator-Objekt.
CMFCRibbonSeparator(BOOL bIsHoriz = FALSE);
Parameter
bIsHoriz
[in] Wenn WAHR, ist das Trennzeichen horizontal; Wenn FALSE, ist das Trennzeichen vertikal.
Hinweise
Horizontale Trennzeichen werden in Anwendungsmenüs verwendet. Vertikale Trennzeichen werden in Symbolleisten verwendet.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie ein Objekt der CMFCRibbonSeparator Klasse erstellt wird.
// CMFCRibbonMainPanel* pMainPanel
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));
CMFCRibbonSeparator::CopyFrom
Eine Kopiermethode, die membervariablen eines Trennzeichens aus einem anderen Objekt festlegt.
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
Parameter
Src
[in] Das Quellmenübandelement, aus dem kopiert werden soll.
CMFCRibbonSeparator::GetRegularSize
Gibt die Größe eines Trennzeichens zurück.
virtual CSize GetRegularSize(CDC* pDC);
Parameter
pDC
[in] Ein Zeiger auf einen Geräteinhalt.
Rückgabewert
Die Größe des Trennzeichens im angegebenen Gerätekontext.
CMFCRibbonSeparator::IsSeparator
Gibt an, ob es sich um ein Trennzeichen handelt.
virtual BOOL IsSeparator() const;
Rückgabewert
Immer TRUE für diese Klasse.
CMFCRibbonSeparator::IsTabStop
Gibt an, ob es sich um einen Tabstopp handelt.
virtual BOOL IsTabStop() const;
Rückgabewert
Immer FALSE für diese Klasse.
Hinweise
Ein Menübandtrennzeichen ist kein Tabstopp.
CMFCRibbonSeparator::OnDraw
Vom System aufgerufen, um das Trennzeichen entweder im Menüband oder auf der Symbolleiste für den Schnellzugriff zu zeichnen.
virtual void OnDraw(CDC* pDC);
Parameter
pDC
[in] Ein Zeiger auf einen Gerätekontext.
CMFCRibbonSeparator::OnDrawOnList
Wird vom System aufgerufen, um das Trennzeichen in der Befehlsliste zu zeichnen.
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
Parameter
pDC
[in] Ein Zeiger auf einen Gerätekontext.
strText
[in] Text, der in der Liste angezeigt wird.
nTextOffset
[in] Abstand zwischen dem Text und der linken Seite des umgebenden Rechtecks.
rect
[in] Gibt das umgebende Rechteck an.
bIsSelected
[in] Ignoriert.
bHighlighted
[in] Ignoriert.