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.
Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer 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
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 eines Untertitel für den Menübandbereich ab.
int GetCaptionHeight() const;
Rückgabewert
Die Höhe eines Untertitel für den Menübandbereich in Pixeln.
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 den Menübandbereich Untertitel 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 das Menübandpanel der Standard Menübandbereich ist.
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 Standard Menübandbereich ist.
Der Standard Menü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
Siehe auch
Hierarchiediagramm
Klassen
CObject-Klasse
CMFCRibbonCategory-Klasse
CMFCRibbonBaseElement-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