CMFCRibbonButton-Klasse

Artikel
02/26/2013

Die CMFCRibbonButton-Klasse implementiert Schaltflächen, die Sie auf Menübandleisteelementen wie Bereichen, Symbolleisten für den Schnellzugriff und Popupmenüs positionieren können.

class CMFCRibbonButton : public CMFCRibbonBaseElement

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCRibbonButton::CMFCRibbonButton	Erstellt ein Menübandschaltflächenobjekt.

Öffentliche Methoden

Name	Description
CMFCRibbonButton::AddSubItem	Fügt ein Menüelement im Popupmenü hinzu, das mit der Schaltfläche zugeordnet ist.
CMFCRibbonButton::CanBeStretched	(Überschreibungen CMFCRibbonBaseElement::CanBeStretched.)
CMFCRibbonButton::CleanUpSizes	(Überschreibungen CMFCRibbonBaseElement::CleanUpSizes.)
CMFCRibbonButton::ClosePopupMenu	(Überschreibungen CMFCRibbonBaseElement::ClosePopupMenu.)
CMFCRibbonButton::DrawBottomText
CMFCRibbonButton::DrawImage	(Überschreibungen CMFCRibbonBaseElement::DrawImage.)
CMFCRibbonButton::DrawRibbonText
CMFCRibbonButton::FindSubItemIndexByID	Gibt den Index eines Popupmenüelements zurück, die der angegebenen Befehl ID zugeordnet ist
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize	Gibt die komprimierte Größe des Menübandelements zurück.(Überschreibungen CMFCRibbonBaseElement::GetCompactSize.)
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex	Gibt den Index des Bilds zurück, das mit der Schaltfläche zugeordnet ist.
CMFCRibbonButton::GetImageSize	Gibt die Größe des Menübandelements zurück.(Überschreibungen CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButton::GetIntermediateSize	Gibt die Größe des Menübandelements in seinem zwischen Zustand zurück.(Überschreibungen CMFCRibbonBaseElement::GetIntermediateSize.)
CMFCRibbonButton::GetMenu	Gibt ein Handle für ein Menü Fenster zurück, das der Menübandschaltfläche zugewiesen wird.
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize	Gibt die reguläre Größe des Menübandelements zurück.(Überschreibungen CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText	EINGABETASTEquickinfotext des Menübandelements.(Überschreibungen CMFCRibbonBaseElement::GetToolTipText.)
CMFCRibbonButton::HasCompactMode	Gibt an, ob das Menübandelement einen kompakten Modus hat.(Überschreibungen CMFCRibbonBaseElement::HasCompactMode.)
CMFCRibbonButton::HasIntermediateMode	Gibt an, ob das Menübandelement einen temporären Modus hat.(Überschreibungen CMFCRibbonBaseElement::HasIntermediateMode.)
CMFCRibbonButton::HasLargeMode	Bestimmt, ob das Menübandelement einen großen Modus hat.(Überschreibungen CMFCRibbonBaseElement::HasLargeMode.)
CMFCRibbonButton::HasMenu	(Überschreibungen CMFCRibbonBaseElement::HasMenu.)
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage	(Überschreibungen CMFCRibbonBaseElement::IsAlwaysLargeImage.)
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand	Bestimmt, ob Sie den Standardbefehl für eine Menübandschaltfläche aktiviert haben.
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu	Bestimmt, ob das Menü rechtsbündig ausgerichtet ist.
CMFCRibbonButton::IsSingleLineText
CMFCRibbonButton::OnCalcTextSize	(Überschreibungen CMFCRibbonBaseElement::OnCalcTextSize.)
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw	Aufgerufen durch das Framework, um das Menübandelement zu zeichnen.(Überschreibungen CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems	Entfernt alle Menüelemente im Popupmenü.
CMFCRibbonButton::RemoveSubItem	Entfernt ein Menüelement aus dem Popupmenü.
CMFCRibbonButton::SetACCData	(Überschreibungen CMFCRibbonBaseElement::SetACCData.)
CMFCRibbonButton::SetAlwaysLargeImage	Gibt an, ob die Schaltfläche ein großes oder kleines Bild angezeigt wird, wenn der Benutzer die Schaltfläche reduziert.
CMFCRibbonButton::SetDefaultCommand	Ermöglicht dem Standardbefehl für die Menübandschaltfläche.
CMFCRibbonButton::SetDescription	Legt die Beschreibung für das Menübandelement fest.(Überschreibungen CMFCRibbonBaseElement::SetDescription.)
CMFCRibbonButton::SetImageIndex	Weist einen Index zu dem Bild der Schaltfläche auf.
CMFCRibbonButton::SetMenu	Weist ein Popupmenü zur Menübandschaltfläche zu.
CMFCRibbonButton::SetParentCategory	(Überschreibungen CMFCRibbonBaseElement::SetParentCategory.)
CMFCRibbonButton::SetRightAlignMenu	Richtet das Popupmenü rechts neben der Schaltfläche aus.
CMFCRibbonButton::SetText	Legt den Text für das Menübandelement fest.(Überschreibungen CMFCRibbonBaseElement::SetText.)

Geschützte Methoden

Name	Description
CMFCRibbonButton::OnClick	Aufgerufen vom Framework, wenn der Benutzer auf die Schaltfläche klickt.

Beispiel

Das folgende Beispiel zeigt, wie die verschiedenen Methoden in der Klasse CMFCRibbonButton verwendet.Im Beispiel wird gezeigt, wie ein Objekt der Klasse CMFCRibbonButton erstellt, ein Popupmenü zur Menübandschaltfläche zuweist, die Beschreibung der Schaltfläche festlegen, ein Menüelement aus dem Popupmenü und von rechts ausrichten das Popupmenü am Rand der Schaltfläche entfernt.

    strTemp.LoadString(IDS_RIBBON_STYLE);
    // The first parameter is the command ID of the button.
    // The third parameter is a zero-based index of the button's small image in the 
    // image list of the parent category.
    // The fourth parameter is a zero-based index of the button's large image in the 
    // image list of the parent category.
    CMFCRibbonButton* pVisualStyleButton = new CMFCRibbonButton(1, strTemp, -1, -1);
    
    pVisualStyleButton->SetMenu(IDR_THEME_MENU, TRUE, TRUE);

    strTemp.LoadString(IDS_RIBBON_STYLE_TIP);
    pVisualStyleButton->SetToolTipText(strTemp);
    strTemp.LoadString(IDS_RIBBON_STYLE_DESC);
    pVisualStyleButton->SetDescription(strTemp);
    pVisualStyleButton->RemoveSubItem(0);
    pVisualStyleButton->SetRightAlignMenu(TRUE);

Hinweise

So fügen Sie einer Menübandschaltfläche in einer Anwendung verwenden, das Button-Objekt erstellen und es dem entsprechenden Menüband Bereich hinzufügen.

CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"),                       // Panel name
    m_PanelIcons.ExtractIcon (0));  // Panel icon
// Create the first button ("Paste"):
CMFCRibbonButton* pPasteButton = 
    new CMFCRibbonButton (ID_EDIT_PASTE, _T("Paste"), -1, 0);
// The third parameter (-1) disables small images for button.
// This button is always displayed with a large image
// Associate a pop-up menu with the "Paste" button:
pPasteButton->SetMenu (IDR_CONTEXT_MENU);
// Add buttons to the panel. These buttons have only small images.
pPanel->Add (new CMFCRibbonButton (ID_EDIT_CUT, _T("Cut"), 1));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_COPY, _T("Copy"), 2));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_PAINT, _T("Paint"), 9));