CMFCRibbonPanel-Klasse

Implementiert einen Bereich, der eine Anzahl von Menübandelementen enthält. Wenn der Bereich gezeichnet wird, werden darin so viele Elemente wie möglich angezeigt.

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

Syntax

class CMFCRibbonPanel : public CObject

Member

Geschützte Konstruktoren

Name	Beschreibung
CMFCRibbonPanel::CMFCRibbonPanel	Erstellt und initialisiert ein CMFCRibbonPanel-Objekt.

Öffentliche Methoden

Name	Beschreibung
CMFCRibbonPanel::Add	Fügt dem Panel ein Menübandelement hinzu.
CMFCRibbonPanel::AddSeparator	Fügt dem Menübandbereich ein Trennzeichen hinzu.
CMFCRibbonPanel::AddToolBar	Fügt dem Menübandbereich eine Symbolleiste hinzu.
CMFCRibbonPanel::FindByData
CMFCRibbonPanel::FindByID	Gibt ein Element zurück, das durch eine angegebene Befehls-ID identifiziert wird.
CMFCRibbonPanel::GetCaptionHeight
CMFCRibbonPanel::GetCount	Gibt die Anzahl der Elemente im Menübandbereich zurück.
CMFCRibbonPanel::GetData	Gibt die benutzerdefinierten Daten zurück, die dem Panel zugeordnet sind.
CMFCRibbonPanel::GetDefaultButton
CMFCRibbonPanel::GetDroppedDown
CMFCRibbonPanel::GetElement	Gibt das Menübandelement zurück, das sich in einem angegebenen Index befindet.
CMFCRibbonPanel::GetElements	Ruft alle Elemente ab, die im Menübandbereich enthalten sind.
CMFCRibbonPanel::GetElementsByID
CMFCRibbonPanel::GetFocused	Gibt ein Fokuselement zurück.
CMFCRibbonPanel::GetGalleryRect	Gibt ein umgebendes Rechteck des Gallery-Elements zurück.
CMFCRibbonPanel::GetHighlighted
CMFCRibbonPanel::GetIndex
CMFCRibbonPanel::GetItemIDsList
CMFCRibbonPanel::GetName
CMFCRibbonPanel::GetParentButton
CMFCRibbonPanel::GetParentCategory	Gibt die übergeordnete Kategorie des Menübandbereichs zurück.
CMFCRibbonPanel::GetParentMenuBar
CMFCRibbonPanel::GetPreferedMenuLocation
CMFCRibbonPanel::GetPressed
CMFCRibbonPanel::GetRect
CMFCRibbonPanel::GetVisibleElements	Ruft ein Array von sichtbaren Elementen ab.
CMFCRibbonPanel::HasElement
CMFCRibbonPanel::HitTest
CMFCRibbonPanel::HitTestEx
CMFCRibbonPanel::Insert	Fügt ein Menübandelement an der angegebenen Position ein.
CMFCRibbonPanel::InsertSeparator	Fügt an der angegebenen Position ein Trennzeichen ein.
CMFCRibbonPanel::IsCenterColumnVert	Gibt an, ob alle Panelelemente vertikal nach Spalte zentriert (ausgerichtet) werden sollen.
CMFCRibbonPanel::IsCollapsed
CMFCRibbonPanel::IsHighlighted
CMFCRibbonPanel::IsJustifyColumns	Gibt an, ob alle Panelspalten dieselbe Breite aufweisen.
CMFCRibbonPanel::IsMainPanel
CMFCRibbonPanel::IsMenuMode
CMFCRibbonPanel::MakeGalleryItemVisible	Scrollt den Katalog, um das angegebene Menübandelement sichtbar zu machen.
CMFCRibbonPanel::OnKey
CMFCRibbonPanel::RecalcWidths
CMFCRibbonPanel::Remove	Entfernt und löscht optional ein Element, das sich am angegebenen Index befindet.
CMFCRibbonPanel::RemoveAll	Entfernt alle Elemente aus dem Menübandbereich.
CMFCRibbonPanel::Replace	Ersetzt ein Element durch ein anderes basierend auf den jeweiligen Indexwerten.
CMFCRibbonPanel::ReplaceByID	Ersetzt ein Element durch ein anderes basierend auf einer angegebenen Befehls-ID.
CMFCRibbonPanel::SetCenterColumnVert	Ordnet das Panel an, elemente vertikal nach Spalte auszurichten.
CMFCRibbonPanel::SetData	Ordnet benutzerdefinierte Daten dem Menübandbereich zu.
CMFCRibbonPanel::SetElementMenu	Weist dem Element mit der angegebenen Befehls-ID ein Popupmenü zu.
CMFCRibbonPanel::SetElementRTC	Fügt dem Menübandbereich ein menübandelement hinzu, das durch die bereitgestellten Informationen zur Laufzeitklasse angegeben wird.
CMFCRibbonPanel::SetElementRTCByID	Fügt dem Menübandbereich ein menübandelement hinzu, das durch die bereitgestellten Informationen zur Laufzeitklasse angegeben wird.
CMFCRibbonPanel::SetFocused	Legt den Fokus auf das angegebene Menübandelement fest.
CMFCRibbonPanel::SetJustifyColumns	Aktiviert oder deaktiviert die Spaltenbeschriftung.
CMFCRibbonPanel::SetKeys	Legt die Tastenkombination fest, die den Menübandbereich anzeigt.
CMFCRibbonPanel::ShowPopup

Hinweise

Menübandbereiche sind logische Gruppierungen verwandter Aufgaben, die Sie in Menübandkategorien erstellen. Wenn sich die Größe des Menübands ändert, wird das Panellayout automatisch so angepasst, dass so viele Elemente wie möglich angezeigt werden.

Sie können ein Menübandpanel abrufen, das in einer Menübandkategorie enthalten ist, indem Sie die CMFCRibbonCategory::GetPanel-Methode aufrufen.

Beispiel

Im folgenden Beispiel wird das Konfigurieren eines CMFCRibbonPanel Objekts mithilfe verschiedener Methoden in der CMFCRibbonPanel Klasse veranschaulicht. Das Beispiel zeigt, wie Sie die Tastenkombination festlegen, die den Menübandbereich anzeigt, Elemente im Bereich vertikal nach Spalte ausrichten und Spaltenausrichtung aktivieren. Dieser Codeausschnitt ist Teil des MS Office 2007-Demobeispiels.

// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();

Vererbungshierarchie

CObject

CMFCRibbonPanel

Anforderungen

Kopfzeile: afxRibbonPanel.h

CMFCRibbonPanel::Add

Fügt das angegebene Menübandelement an das Array von Menübandelementen an, die im Menübandbereich enthalten sind.

virtual void Add(CMFCRibbonBaseElement* pElem);

Parameter

pElem
[in, out] Zeiger auf ein Menübandelement.

Hinweise

CMFCRibbonPanel::AddSeparator

Fügt dem Menübandbereich ein Trennzeichen hinzu.

virtual void AddSeparator();

Hinweise

Rufen Sie diese Methode auf, um dem Menübandbereich ein Trennzeichen hinzuzufügen. Das Trennzeichen wird neben dem Menübandelement hinzugefügt, das durch den vorherigen Aufruf von CMFCRibbonPanel::Add hinzugefügt wurde. Um ein Trennzeichen an einer bestimmten Position einzufügen, rufen Sie CMFCRibbonPanel::InsertSeparator auf.

CMFCRibbonPanel::AddToolBar

Fügt dem Menübandbereich eine Symbolleiste hinzu.

CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);

Parameter

uiToolbarResID
[in] Gibt die Ressourcen-ID der hinzuzufügenden Symbolleiste an.

uiColdResID
[in] Gibt die Ressourcen-ID der kalten Bilder der Symbolleiste an.

uiHotResID
[in] Gibt die Ressourcen-ID der Hot Images der Symbolleiste an.

uiDisabledResID
[in] Gibt die Ressourcen-ID der deaktivierten Bilder der Symbolleiste an.

Rückgabewert

Rufen Sie diese Methode auf, um dem Menübandbereich eine Symbolleiste hinzuzufügen. Die Symbolleiste wird neben dem Menübandelement hinzugefügt, das durch den vorherigen Aufruf von CMFCRibbonPanel::Add hinzugefügt wurde.

Hinweise

Weitere Informationen zu Symbolleisten, heißen Bildern, kalten Bildern und deaktivierten Bildern finden Sie unter CMFCToolBar Class.

CMFCRibbonPanel::CMFCRibbonPanel

Erstellt und initialisiert ein CMFCRibbonPanel -Objekt.

CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);

CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);

Parameter

lpszName
[in] Der Name des Menübandbereichs.

hIcon
[in] Behandeln Sie das Symbol der Standardschaltfläche für den Menübandbereich.

pPaletteButton
[in] Zeigen Sie auf einen Menübandkatalog für den Menübandbereich.

CMFCRibbonPanel::FindByData

Ruft das Menübandelement ab, das den angegebenen Daten zugeordnet ist.

CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;

Parameter

dwData
[in] Die daten, die einem Menübandelement zugeordnet sind.

Rückgabewert

Zeigen Sie auf ein Menübandelement, wenn die Methode erfolgreich war; andernfalls NULL.

Hinweise

CMFCRibbonPanel::FindByID

Ruft das Menübandelement ab, das durch die angegebene Befehls-ID identifiziert wird.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;

Parameter

uiCmdID
[in] Die Befehls-ID eines Menübandelements.

Rückgabewert

Das Menübandelement, das durch die angegebene Befehls-ID identifiziert wird; andernfalls NULL, wenn kein Menübandelement mit der angegebenen Befehls-ID identifiziert wird.

CMFCRibbonPanel::GetCaptionHeight

Ruft die Höhe einer Beschriftung für den Menübandbereich ab.

int GetCaptionHeight() const;

Rückgabewert

Die Höhe in Pixeln einer Beschriftung für den Menübandbereich.

Hinweise

CMFCRibbonPanel::GetCount

Ruft die Anzahl der Menübandelemente ab, die im Menübandbereich enthalten sind.

int GetCount() const;

Rückgabewert

Die Anzahl der Menübandelemente, die im Menübandbereich enthalten sind.

CMFCRibbonPanel::GetData

Gibt die benutzerdefinierten Daten zurück, die dem Panel zugeordnet sind.

DWORD_PTR GetData() const;

Rückgabewert

Die benutzerdefinierten Daten, die dem Panel zugeordnet sind.

CMFCRibbonPanel::GetDefaultButton

Ruft die Standardschaltfläche für den Menübandbereich ab.

CMFCRibbonButton& GetDefaultButton();

Rückgabewert

Die Standardschaltfläche für den Menübandbereich.

Hinweise

Die Standardschaltfläche wird angezeigt, wenn ein Menübandbereich nicht genügend Platz zum Anzeigen der Menübandelemente aufweist.

CMFCRibbonPanel::GetDroppedDown

Ruft einen Zeiger auf ein Menübandelement ab, wenn das Popupmenü gelöscht wird.

CMFCRibbonBaseElement* GetDroppedDown() const;

Rückgabewert

Zeigen Sie auf das Menübandelement, in dem das Popupmenü nach unten verschoben wurde. andernfalls NULL, wenn kein Menübandelement das Popupmenü heruntergesetzt hat.

Hinweise

Es werden nur Menübandelemente getestet, die im Menübandbereich enthalten sind.

CMFCRibbonPanel::GetElement

Gibt das Menübandelement zurück, das sich in einem angegebenen Index befindet.

CMFCRibbonBaseElement* GetElement(int nIndex) const;

Parameter

nIndex
[in] Gibt den nullbasierten Index des abzurufenden Elements an.

Rückgabewert

Ein gültiger Zeiger auf das Basismenübandelement, das sich an Position nIndex im Menübandbereich befindet, oder NULL, wenn kein Element am angegebenen Index vorhanden ist.

CMFCRibbonPanel::GetElements

Ruft alle Menübandelemente ab, die im Menübandbereich enthalten sind.

void GetElements(CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parameter

arElements
[out] Ein Array, das mit allen Menübandelementen gefüllt werden soll, die im Menübandbereich enthalten sind.

Hinweise

CMFCRibbonPanel::GetElementsByID

Fügt dem angegebenen Array Menübandelemente hinzu, die über die angegebene Befehls-ID verfügen.

void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parameter

uiCmdID
[in] Befehls-ID für ein Menübandelement.

arElements
[in] Array von Menübandelementen.

Hinweise

Es werden nur Menübandelemente getestet, die im Menübandbereich enthalten sind.

CMFCRibbonPanel::GetHighlighted

Ruft das Menübandelement ab, das im Menübandbereich hervorgehoben ist.

CMFCRibbonBaseElement* GetHighlighted() const;

Rückgabewert

Zeigen Sie auf das Menübandelement, das im Menübandbereich hervorgehoben ist.

Hinweise

CMFCRibbonPanel::GetIndex

Ruft den nullbasierten Index des angegebenen Menübandelements aus dem Array der Menübandelemente ab, die im Menübandbereich enthalten sind.

virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;

Parameter

pElem
[in] Zeiger auf ein Menübandelement.

Rückgabewert

Nullbasierter Index des angegebenen Menübandelements, wenn die Methode erfolgreich war; andernfalls -1.

Hinweise

CMFCRibbonPanel::GetItemIDsList

Ruft die Befehls-IDs für alle Menübandelemente im Menübandbereich ab.

void GetItemIDsList(CList<UINT, UINT>& lstItems) const;

Parameter

lstItems
[out] Die Liste der Befehls-IDs für Menübandelemente, die im Menübandbereich enthalten sind.

Hinweise

CMFCRibbonPanel::GetName

Ruft den Namen des Menübandbereichs ab.

LPCTSTR GetName() const;

Rückgabewert

Der Name des Menübandbereichs.

Hinweise

CMFCRibbonPanel::GetParentButton

CMFCRibbonBaseElement* GetParentButton() const;

Rückgabewert

Bemerkungen

CMFCRibbonPanel::GetParentCategory

Gibt die übergeordnete Kategorie des Menübandbereichs zurück.

CMFCRibbonCategory* GetParentCategory() const;

Rückgabewert

Ein Zeiger auf die Menübandkategorie, die diesen Menübandbereich enthält.

CMFCRibbonPanel::GetParentMenuBar

CMFCRibbonPanelMenuBar* GetParentMenuBar() const;

Rückgabewert

Bemerkungen

CMFCRibbonPanel::GetPreferedMenuLocation

Ruft das bevorzugte Anzeigerechteck für das Popupmenü des Menübandbereichs ab.

virtual BOOL GetPreferedMenuLocation(CRect& rect);

Parameter

rect
[out] Dieser Parameter wird nicht verwendet.

Rückgabewert

Gibt immer FALSE zurück.

Hinweise

Diese Methode gibt immer FALSE zurück. Überschreiben Sie diese Methode, um das bevorzugte Anzeigerechteck für das Popupmenü des Menübandbereichs abzurufen.

CMFCRibbonPanel::GetPressed

Ruft einen Zeiger auf ein Menübandelement im Menübandbereich ab, wenn der Benutzer ihn gerade drückt.

CMFCRibbonBaseElement* GetPressed() const;

Rückgabewert

Ein Zeiger auf ein Menübandelement, wenn der Benutzer es zurzeit drückt; andernfalls NULL.

Hinweise

CMFCRibbonPanel::GetRect

Ruft das Anzeigerechteck für den Menübandbereich ab.

const CRect& GetRect() const;

Rückgabewert

Das Anzeigerechteck für den Menübandbereich.

Hinweise

CMFCRibbonPanel::HasElement

Gibt an, ob das Menübandpanel das angegebene Menübandelement enthält.

BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;

Parameter

pElem
[in] Zeiger auf ein Menübandelement.

Rückgabewert

TRUE, wenn der Menübandbereich das angegebene Menübandelement enthält; andernfalls FALSE.

Hinweise

CMFCRibbonPanel::Highlight

Legt die Hervorhebungsfarbe für den ausgewählten Menübandbereich und für das vom Punkt angegebene Menübandelement fest.

virtual void Highlight(
BOOL bHighlight,
CPoint point);

Parameter

bHighlight
[in] TRUE, um den Menübandbereich hervorzuheben; FALSE, um den Menübandbereich einzublenden.

Punkt
[in] Die X- und Y-Koordinaten des Zeigers relativ zur oberen linken Ecke des Fensters.

Hinweise

CMFCRibbonPanel::HitTest

Ruft ein Menübandelement ab, wenn sich der angegebene Punkt darin befindet.

virtual CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE);

Parameter

Punkt
[in] Die X- und Y-Koordinaten des Zeigers relativ zur oberen linken Ecke des Fensters.

bCheckPanelCaption
[in] TRUE, um die Beschriftung des Menübandbereichs zu testen; andernfalls FALSE.

Rückgabewert

Zeiger auf ein Menübandelement, wenn sich der angegebene Punkt darin befindet; andernfalls NULL.

Hinweise

Es werden nur Menübandelemente getestet, die im Menübandbereich enthalten sind.

CMFCRibbonPanel::HitTestEx

Ruft den nullbasierten Index des Menübandelements ab, das den angegebenen Punkt enthält.

virtual int HitTestEx(CPoint point) const;

Parameter

Punkt
[in] Die X- und Y-Koordinaten des Zeigers relativ zur oberen linken Ecke des Fensters.

Rückgabewert

Der nullbasierte Index des Menübandelements, das den angegebenen Punkt darin enthält; andernfalls -1.

Hinweise

Es werden nur Menübandelemente getestet, die im Menübandbereich enthalten sind.

CMFCRibbonPanel::Insert

Fügt das angegebene Menübandelement an der angegebenen Position im Array von Menübandelementen ein, die im Menübandbereich enthalten sind.

virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);

Parameter

pElem
[in, out] Zeiger auf ein Menübandelement.

nIndex
[in] Nullbasierter Wert, von -1 bis zur Anzahl der Menübandelemente, die im Array enthalten sind.

Rückgabewert

TRUE, wenn das Menübandelement erfolgreich eingefügt wurde; andernfalls FALSE.

Hinweise

Wenn der Wert von nIndex -1 ist oder nIndex der Anzahl der Menübandelemente im Array entspricht, wird das angegebene Menübandelement am Ende des Arrays hinzugefügt. Wenn der Wert von nIndex außerhalb des Zulässigen liegt, schlägt die Methode fehl.

CMFCRibbonPanel::InsertSeparator

Fügt an der angegebenen Position ein Trennzeichen ein.

virtual BOOL InsertSeparator(int nIndex);

Parameter

nIndex
[in] Gibt den nullbasierten Index an, in den das Trennzeichen eingefügt wird.

Rückgabewert

TRUE, wenn das Trennzeichen erfolgreich eingefügt wurde; andernfalls FALSE.

Hinweise

Rufen Sie diese Methode auf, um ein Trennzeichen an der durch nIndex angegebenen Position einzufügen. Rufen Sie CMFCRibbonPanel::AddSeparator auf, um neben dem zuletzt hinzugefügten Menübandelement ein Trennzeichen einzufügen.

CMFCRibbonPanel::IsCenterColumnVert

Gibt an, ob die vertikalen Positionen von Menübandelementen innerhalb des Anzeigerechtecks zentriert sind.

BOOL IsCenterColumnVert() const;

Rückgabewert

TRUE, wenn die vertikalen Positionen von Menübandelementen innerhalb ihres Anzeigerechtecks zentriert sind; andernfalls FALSE.

CMFCRibbonPanel::IsCollapsed

Gibt an, ob die Anzeigegröße des Menübandbereichs in horizontaler Richtung minimiert wird.

BOOL IsCollapsed() const;

Rückgabewert

TRUE, wenn die Anzeigegröße des Menübandpanels in horizontaler Richtung minimiert wird; andernfalls FALSE.

Hinweise

Wenn ein Menübandbereich reduziert ist, wird nur die Standardschaltfläche, der Name und ein Dropdownpfeil angezeigt.

CMFCRibbonPanel::IsHighlighted

Gibt an, ob die Anzeige des Menübandbereichs hervorgehoben ist.

BOOL IsHighlighted() const;

Rückgabewert

TRUE, wenn die Anzeige des Menübandbereichs hervorgehoben ist; andernfalls FALSE.

Hinweise

Die Anzeige eines Menübandpanels wird hervorgehoben, wenn der Mauszeiger darauf zeigt.

CMFCRibbonPanel::IsJustifyColumns

Gibt an, ob die Anzeigeabmessungen von Menübandelementen, die sich in derselben Spalte im Menübandbereich befinden, auf dieselbe Breite festgelegt sind.

BOOL IsJustifyColumns() const;

Rückgabewert

TRUE, wenn die Anzeigeabmessungen von Menübandelementen, die sich in derselben Spalte im Menübandbereich befinden, auf dieselbe Breite festgelegt sind; andernfalls FALSE.

CMFCRibbonPanel::IsMainPanel

Gibt an, ob es sich bei dem Menübandbereich um den Hauptmenübandbereich handelt.

virtual BOOL IsMainPanel() const;

Rückgabewert

Gibt immer FALSE zurück.

Hinweise

Diese Methode gibt immer FALSE zurück. Überschreiben Sie diese Methode, um anzugeben, ob das Menübandpanel der Hauptmenübandbereich ist.

Der Hauptmenübandbereich wird angezeigt, wenn der Benutzer die Anwendungsschaltfläche auswählt.

CMFCRibbonPanel::IsMenuMode

BOOL IsMenuMode() const;

Rückgabewert

Bemerkungen

CMFCRibbonPanel::OnKey

virtual BOOL OnKey(UINT nChar);

Parameter

[in] nChar

Rückgabewert

Bemerkungen

CMFCRibbonPanel::RecalcWidths

Berechnet die Breite jeder Anzeigelayoutkonfiguration für den Menübandbereich neu.

virtual void RecalcWidths(
CDC* pDC,
int nHeight);

Parameter

pDC
[in] Zeigen Sie auf einen Gerätekontext für den Menübandbereich.

nHeight
[in] Die Höhe des Menübandbereichs.

Hinweise

Ein Menübandbereich ändert seine Layoutkonfiguration, wenn sich die verfügbare Breite ändert.

CMFCRibbonPanel::Remove

Entfernt und löscht optional ein Element, das sich am angegebenen Index befindet.

BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);

Parameter

nIndex
[in] Gibt den nullbasierten Index des Elements an, das aus dem Menübandbereich entfernt wird.

bDelete
[in] TRUE, um das zu entfernende Element zu löschen; andernfalls FALSE.

Rückgabewert

TRUE, wenn das Element entfernt und gelöscht wurde (wenn bDelete TRUE ist); FALSE, wenn das Element nicht entfernt wurde oder kein Menübandelement in nIndex vorhanden ist.

Hinweise

Rufen Sie diese Methode auf, um ein Element aus dem Menübandbereich zu entfernen.

CMFCRibbonPanel::RemoveAll

Löscht alle Menübandelemente aus dem Menübandbereich.

void RemoveAll();

Hinweise

Alle Menübandelemente werden aus dem Menübandbereich gelöscht und zerstört.

CMFCRibbonPanel::Replace

Ersetzt ein Element anhand ihres Indexwerts durch ein anderes Element.

BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);

Parameter

nIndex
[in] Gibt den nullbasierten Index des zu ersetzenden Elements an.

pElem
[in, out] Ein gültiger Zeiger auf das Element, das das ursprüngliche Element ersetzt.

Rückgabewert

TRUE, wenn das ursprüngliche Menübandelement erfolgreich durch das neue Menübandelement ersetzt wurde; FALSE, wenn das Menübandelement nicht ersetzt wurde oder kein Element im angegebenen Index vorhanden ist.

Hinweise

Rufen Sie CMFCRibbonPanel::ReplaceByID auf, um ein Menübandelement durch Befehls-ID zu ersetzen.

CMFCRibbonPanel::ReplaceByID

Ersetzt ein Element durch ein anderes basierend auf einer angegebenen Befehls-ID.

BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);

Parameter

uiCmdID
[in] Gibt die Befehls-ID des zu ersetzenden Elements an.

pElem
[in, out] Ein gültiger Zeiger auf das Element, das das ursprüngliche Element ersetzt.

Rückgabewert

TRUE, wenn das ursprüngliche Menübandelement erfolgreich durch das neue Menübandelement ersetzt wurde; FALSE, wenn das Menübandelement nicht ersetzt wurde oder kein Element mit der angegebenen Befehls-ID vorhanden ist.

Hinweise

Rufen Sie CMFCRibbonPanel::Replace auf, um ein Menübandelement basierend auf der Position zu ersetzen.

CMFCRibbonPanel::SetCenterColumnVert

Aktiviert oder deaktiviert die Zentrierung der vertikalen Positionen von Menübandelementen innerhalb des Anzeigerechtecks.

void SetCenterColumnVert(BOOL bSet = TRUE);

Parameter

bSet
[in] TRUE, um die vertikalen Positionen von Menübandelementen innerhalb ihres Anzeigerechtecks zu zentrieren; FALSE, um dieses Feature zu deaktivieren.

Hinweise

CMFCRibbonPanel::SetData

Ordnet benutzerdefinierte Daten dem Menübandbereich zu.

void SetData(DWORD_PTR dwData);

Parameter

dwData
[in] Gibt die festzulegenden benutzerdefinierten Daten an.

Hinweise

Rufen Sie diese Methode auf, um benutzerdefinierte Daten dem Menübandbereich zuzuordnen.

CMFCRibbonPanel::SetElementMenu

Weist dem Element mit der angegebenen Befehls-ID ein Popupmenü zu.

BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

Parameter

uiCmdID
[in] Gibt die Befehls-ID des Menübandelements an, in dem das Menü hinzugefügt wird.

hMenu
[in] Gibt das Handle für das Windows-Menü an, das dem Menübandbereich hinzugefügt werden soll.

bIsDefautCommand
[in] TRUE, um anzugeben, dass der dem Menübandelement zugeordnete Befehl ausgeführt werden soll, wenn auf das Menübandelement geklickt wird. In diesem Fall wird das Menü nur geöffnet, wenn der Benutzer auf den Pfeil neben dem Menübandelement klickt. FALSE, um anzugeben, dass der dem Menübandelement zugeordnete Befehl nicht ausgeführt werden soll, wenn auf das Menübandelement geklickt wird. In diesem Fall wird das Popupmenü unabhängig davon angezeigt, wo der Benutzer auf das Element klickt.

bRightAlign
[in] TRUE, um anzugeben, dass das Popupmenü rechtsbündig ausgerichtet ist; andernfalls FALSE.

uiMenuResID
[in] Gibt die Ressourcen-ID des Menüs an, das dem Menübandbereich hinzugefügt werden soll.

Rückgabewert

TRUE, wenn das Menü dem Menübandelement zugewiesen wurde; andernfalls FALSE.

Hinweise

Rufen Sie diese Methode auf, um dem Menübandelement ein Popupmenü mit der angegebenen Befehls-ID zuzuweisen.

CMFCRibbonPanel::SetElementRTC

Fügt das Menübandelement hinzu, das durch die bereitgestellten Laufzeitklasseninformationen zum Menübandbereich angegeben wird.

CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);

Parameter

nIndex
[in] Gibt den nullbasierten Index des hinzuzufügenden Menübandelements an.

pRTC
[in, out] Ein Zeiger auf die Laufzeitklasseninformationen für das Menübandelement, das dem Menübandbereich hinzugefügt wird.

Rückgabewert

Das Menübandelement, das mithilfe der angegebenen Laufzeitklasseninformationen erstellt wurde.

Hinweise

Wenn Sie dem Menübandbereich ein benutzerdefiniertes Element (z. B. eine Farbschaltfläche) hinzufügen möchten, müssen Sie die Laufzeitklasseninformationen des benutzerdefinierten Elements angeben. Das Menüband speichert diese Informationen, erstellt das benutzerdefinierte Element und ersetzt ein vorhandenes Element, das sich (identifiziert durch) der angegebenen Befehls-ID befindet. Das Menüband gibt dann einen Zeiger auf das neu erstellte Element zurück.

CMFCRibbonPanel::SetElementRTCByID

Fügt dem Menübandbereich ein Menübandelement hinzu, das durch die bereitgestellten Laufzeitklasseninformationen angegeben wird.

CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);

Parameter

uiCmdID
[in] Gibt die Befehls-ID des hinzuzufügenden Menübandelements an.

pRTC
[in, out] Ein Zeiger auf die Laufzeitklasseninformationen, die dem Menübandelement zugeordnet sind, das dem Menübandbereich hinzugefügt wird.

Rückgabewert

Das Menübandelement, das mithilfe der angegebenen Laufzeitklasseninformationen erstellt wurde.

Hinweise

Wenn Sie dem Menübandbereich ein benutzerdefiniertes Element (z. B. eine Farbschaltfläche) hinzufügen möchten, müssen Sie die Laufzeitklasseninformationen des benutzerdefinierten Elements angeben. Das Menüband speichert diese Informationen, erstellt das benutzerdefinierte Element und ersetzt ein vorhandenes Element, das sich durch die angegebene Befehls-ID befindet. Anschließend wird ein Zeiger auf das neu erstellte Element zurückgegeben.

Beispiel

Das folgende Beispiel zeigt, wie die SetElementRTCByID Methode verwendet wird:

// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:

pPanel->AddToolBar(IDR_MAINFRAME,
    IDB_MAINFRAME256);

CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
    RUNTIME_CLASS (CMFCRibbonColorButton));

// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
    which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
    RGB (0,
    0,
    0));

CMFCRibbonPanel::SetJustifyColumns

Aktiviert oder deaktiviert die Anpassung der Breite von Menübandelementen in derselben Spalte.

void SetJustifyColumns(BOOL bSet = TRUE);

Parameter

bSet
[in] TRUE, um die Breite der Menübandelemente in derselben Spalte auf die Breite des größten Menübandelements in der Spalte anzupassen; FALSE, um diese Breiteanpassung zu deaktivieren.

Hinweise

Wenn dieses Feature in einem Menübandbereich aktiviert ist, werden die Breite der Menübandelemente in derselben Spalte an die Breite des größten Menübandelements in derselben Spalte angepasst.

CMFCRibbonPanel::SetKeys

Legt die Zugriffstasteninfo für die Standardschaltfläche des Menübandbereichs fest.

void SetKeys(LPCTSTR lpszKeys);

Parameter

lpszKeys
[in] Die Zugriffstasteninfo für die Standardschaltfläche des Menübandbereichs.

Hinweise

Die Standardschaltfläche wird angezeigt, wenn ein Menübandbereich nicht genügend Platz zum Anzeigen der Menübandelemente aufweist.

CMFCRibbonPanel::ShowPopup

Erstellt und zeigt ein Popupmenü für den Menübandbereich an.

CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);

Parameter

pButton
[in] Zeigen Sie auf die Standardschaltfläche für den Menübandbereich.

Rückgabewert

Zeigen Sie auf das Popupmenü für den Menübandbereich, wenn die Methode erfolgreich war; andernfalls NULL.

Hinweise

Das Popupmenü für den Menübandbereich ist nur verfügbar, wenn die Anzeige des Menübandpanels reduziert ist.

CMFCRibbonPanel::SetFocused

Legt den Fokus auf das angegebene Menübandelement fest.

void SetFocused(CMFCRibbonBaseElement* pNewFocus);

Parameter

pNewFocus
Ein Zeiger auf ein Menübandelement, das den Fokus erhält.

Hinweise

CMFCRibbonPanel::MakeGalleryItemVisible

Scrollt den Katalog, um das angegebene Menübandelement sichtbar zu machen.

void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);

Parameter

pItem
Ein Zeiger auf ein anzuzeigende Menübandelement.

Hinweise

CMFCRibbonPanel::IsWindows7Look

Gibt an, ob das übergeordnete Menüband windows 7 aussieht (kleine rechteckige Anwendungsschaltfläche).

BOOL IsWindows7Look() const;

Rückgabewert

TRUE, wenn das übergeordnete Menüband windows 7 aussieht; andernfalls FALSE.

Hinweise

CMFCRibbonPanel::GetVisibleElements

Ruft ein Array von sichtbaren Elementen ab.

void GetVisibleElements(
CArray<CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);

Parameter

arElements
Wenn die Funktion zurückgegeben wird, enthält dieser Parameter ein Array sichtbarer Elemente.

Hinweise

CMFCRibbonPanel::GetGalleryRect

Gibt ein umgebendes Rechteck eines Gallery-Elements zurück.

CRect GetGalleryRect();

Rückgabewert

Größe und Position des Gallery-Elements in diesem Bereich.

Hinweise

CMFCRibbonPanel::GetFocused

Gibt ein Fokuselement zurück.

CMFCRibbonBaseElement* GetFocused() const;

Rückgabewert

Ein Zeiger auf ein fokussiertes Element oder NULL.

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CObject-Klasse
CMFCRibbonCategory-Klasse
CMFCRibbonBaseElement-Klasse