Freigeben über


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

CObject

CMFCRibbonBaseElement

CMFCRibbonSeparator

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.

Siehe auch

Hierarchiediagramm
Klassen