CMFCRibbonBaseElement-Klasse

Artikel
02/26/2013

Die CMFCRibbonBaseElement-Klasse ist die Basisklasse für alle Elemente, die Sie Menübandleiste hinzufügen können.Beispiele für Menübandelementen sind Menübandschaltflächen, Menübandkontrollkästchen und Menübandkombinationsfelder.

class CMFCRibbonBaseElement : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCRibbonBaseElement	Erstellt ein CMFCRibbonBaseElement-Objekt.

Öffentliche Methoden

Name	Description
CMFCRibbonBaseElement::AddToKeyList	Fügt ein keytip für das Menübandelement ein Array keytips hinzu.
CMFCRibbonBaseElement::AddToListBox	Fügt ein Menübandelement dem angegebenen Menübandbefehlslistenfeld hinzu.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar	Gibt an, ob das Menübandelement zur Symbolleiste für den Schnellzugriff hinzugefügt werden kann.
CMFCRibbonBaseElement::CanBeCompacted	Gibt an, ob die Größe des Menübandelements kompakt sein kann.
CMFCRibbonBaseElement::CanBeStretched	Gibt an, ob die Höhe des Menübandelements auf die Höhe einer Menübandzeile vertikal zunehmen kann.
CMFCRibbonBaseElement::CanBeStretchedHorizontally	Gibt an, ob die Breite des Menübandelements ändern kann.
CMFCRibbonBaseElement::CleanUpSizes	Die bereinigt die erlaubt für das Menübandelement auf.
CMFCRibbonBaseElement::ClosePopupMenu	Schließt das Kontextmenü für das Menübandelement.
CMFCRibbonBaseElement::CopyFrom	Kopiert den Zustand angegebenen CMFCRibbonBaseElement auf das aktuelle Objekt.
CMFCRibbonBaseElement::DestroyCtrl	Zerstört das Menübandelement.
CMFCRibbonBaseElement::DrawImage	Zeichnet das Bild für das Menübandelement.
CMFCRibbonBaseElement::Find	Gibt den angegebenen Zeiger auf das Menübandelement zurück, wenn das aktuelle Objekt verweist.
CMFCRibbonBaseElement::FindByData	Ruft einen Zeiger auf das Menübandelement ab, wenn die angegebenen Daten enthält.
CMFCRibbonBaseElement::FindByID	Ruft einen Zeiger auf das Menübandelement ab, wenn dieses Element durch die angegebene Befehl ID identifiziert wird
CMFCRibbonBaseElement::FindByOriginal	Ruft einen Zeiger auf das Menübandelement ab, wenn sein Vorlagenmenübandelement das angegebene Menübandelement übereinstimmt.
CMFCRibbonBaseElement::GetCompactSize	Gibt die komprimierte Größe des Menübandelements zurück.
CMFCRibbonBaseElement::GetData	Ruft die benutzerdefinierten Daten ab, die dem Menübandelement zugeordnet werden.
CMFCRibbonBaseElement::GetDescription	Gibt die Beschreibung des Menübandelements zurück.
CMFCRibbonBaseElement::GetDroppedDown	Ruft einen Zeiger auf das Menübandelement ab, wenn das Popupmenü unten abgelegt wird.
CMFCRibbonBaseElement::GetElements	Fügt das aktuelle Menübandelement dem angegebenen Array hinzu.
CMFCRibbonBaseElement::GetElementsByID	Fügt das aktuelle Menübandelement dem angegebenen Array hinzu, wenn das aktuelle Menübandelement Befehl die angegebene ID enthält
CMFCRibbonBaseElement::GetHighlighted	Ruft einen Zeiger auf das Menübandelement ab, wenn es hervorgehoben wird.
CMFCRibbonBaseElement::GetID	Gibt die Befehls-ID des Menübandelements zurück.
CMFCRibbonBaseElement::GetImageSize	Gibt die Größe des Menübandelements zurück.
CMFCRibbonBaseElement::GetIntermediateSize	Gibt die Größe des Menübandelements in seinem zwischen Zustand zurück.
CMFCRibbonBaseElement::GetKeys	Gibt das keytip zurück, das mit dem Menübandelement zugeordnet ist.
CMFCRibbonBaseElement::GetKeyTipRect	Ruft das keytip Grenzenrechteck für das Menübandelement ab.
CMFCRibbonBaseElement::GetKeyTipSize	Ruft die Größe des keytip Text.
CMFCRibbonBaseElement::GetLocationInGroup	Gibt den Anzeigenspeicherort des Menübandelements in einer Menübandgruppe an.
CMFCRibbonBaseElement::GetMenuKeys	Gibt die keytips zurück, die mit einer Schaltfläche zugeordnet werden.
CMFCRibbonBaseElement::GetNotifyID	Ruft die Benachrichtigungsbefehls-id für das Menübandelement ab.
CMFCRibbonBaseElement::GetOriginal	Ruft das ursprüngliche Menübandelement ab.
CMFCRibbonBaseElement::GetParentCategory	Ruft die Menübandkategorie für das Menübandelement ab.
CMFCRibbonBaseElement::GetParentPanel	Ruft den Favoritenmenübandbereich ab, der das Menübandelement enthält.
CMFCRibbonBaseElement::GetParentRibbonBar	Ruft die Elemente Menübandleiste für das Menübandelement ab.
CMFCRibbonBaseElement::GetParentWnd	Ruft das übergeordnete Fenster für das Menübandelement ab.
CMFCRibbonBaseElement::GetPressed	Ruft einen Zeiger auf das Menübandelement ab, wenn der Benutzer es momentan drückt.
CMFCRibbonBaseElement::GetQuickAccessToolBarID	Ruft die Befehls-ID des Menübandelements ab, wenn sie in der Symbolleiste für den Schnellzugriff ist.
CMFCRibbonBaseElement::GetRect	Gibt das umschließende Rechteck des Menübandelements zurück.
CMFCRibbonBaseElement::GetRegularSize	Gibt die reguläre Größe des Menübandelements zurück.
CMFCRibbonBaseElement::GetSize	Gibt die aktuelle Größe des Menübandelements zurück.
CMFCRibbonBaseElement::GetText	Gibt den Text zurück, der mit dem Menübandelement zugeordnet ist.
CMFCRibbonBaseElement::GetToolTipText	EINGABETASTEquickinfotext des Menübandelements.
CMFCRibbonBaseElement::GetTopLevelRibbonBar	Ruft die Menübandleiste der obersten Ebene für das Menübandelement ab.
CMFCRibbonBaseElement::HasCompactMode	Gibt an, ob das Menübandelement einen kompakten Modus hat.
CMFCRibbonBaseElement::HasFocus	Gibt an, ob das übergeordnete Element den Tastaturfokus hat.
CMFCRibbonBaseElement::HasIntermediateMode	Gibt an, ob das Menübandelement einen temporären Modus hat.
CMFCRibbonBaseElement::HasLargeMode	Gibt an, ob das Menübandelement einen großen Modus hat.
CMFCRibbonBaseElement::HasMenu	Gibt an, ob das Menübandelement ein Menü enthält.
CMFCRibbonBaseElement::HitTest	Ruft einen Zeiger auf das Menübandelement ab, wenn der angegebene Punkt in ihm ist.
CMFCRibbonBaseElement::IsAlignByColumn	Gibt an, ob das Menübandelement vertikal mit anderen Menübandelementen ausgerichtet ist.
CMFCRibbonBaseElement::IsAlwaysLargeImage	Gibt an, ob die Menübandelement-Imagegröße immer groß ist.
CMFCRibbonBaseElement::IsAutoRepeatMode	Gibt an, ob das Menübandelement im automatischen Wiederholungsmodus ist.
CMFCRibbonBaseElement::IsChecked	Gibt an, ob das Menübandelement überprüft wird.
CMFCRibbonBaseElement::IsCompactMode	Gibt an, ob das Menübandelement in einem kompakten Modus ist.
CMFCRibbonBaseElement::IsDefaultMenuLook
CMFCRibbonBaseElement::IsDisabled	Gibt an, ob das Menübandelement deaktiviert ist.
CMFCRibbonBaseElement::IsDroppedDown	Bestimmt, ob das Menübandelement ein Popupmenü angezeigt und unten abgelegt wird.
CMFCRibbonBaseElement::IsFocused	Gibt an, ob das Menübandelement den Fokus besitzt.
CMFCRibbonBaseElement::IsGalleryIcon	Gibt an, ob das Menübandelement in einem Menübandkatalog enthalten ist.
CMFCRibbonBaseElement::IsHighlighted	Gibt an, ob Menübandelement hervorgehoben wird.
CMFCRibbonBaseElement::IsIntermediateMode	Gibt an, ob das aktuelle Bild für das Menübandelement zwischen Größe ist.
CMFCRibbonBaseElement::IsLargeMode	Gibt an, ob das aktuelle Bild für das Menübandelement großformatig ist.
CMFCRibbonBaseElement::IsMenuMode	Gibt an, ob das Menübandelement in einem Menü enthalten ist.
CMFCRibbonBaseElement::IsPressed	Gibt an, ob der Benutzer auf das Menübandelement geklickt hat.
CMFCRibbonBaseElement::IsQATMode	Gibt an, ob das Menübandelement in der Symbolleiste für den Schnellzugriff enthalten ist.
CMFCRibbonBaseElement::IsSeparator	Gibt an, ob das Menübandelement ein Anzeigentrennzeichen ist.
CMFCRibbonBaseElement::IsShowGroupBorder	Gibt an, ob das Menübandelement in einer Gruppe enthalten sind, die eine gemeinsame Begrenzung anzeigt.
CMFCRibbonBaseElement::IsShowTooltipOnBottom	Gibt an, ob die QuickInfo unter dem Menüband angezeigt wird.
CMFCRibbonBaseElement::IsTabStop	Gibt an, ob das Menübandelement mit der Tastatur ausgewählt werden kann.
CMFCRibbonBaseElement::IsTextAlwaysOnRight	Gibt an, ob der Text für das Menübandelement auf der rechten Seite angezeigt wird.
CMFCRibbonBaseElement::IsVisible	Gibt an, ob das Menübandelement gerade angezeigt wird.
CMFCRibbonBaseElement::IsWholeRowHeight	Gibt an, ob das heigth Anzeige des Menübandelements dasselbe wie die Anzeigenhöhe des Menübandbereichs ist, der es enthält.
CMFCRibbonBaseElement::NotifyCommand	Sendet eine Befehlsbenachrichtigung zum übergeordneten Fenster des Menübandelements.
CMFCRibbonBaseElement::NotifyHighlightListItem	Benachrichtigt das übergeordnete Fenster der Menübandleiste, wenn ein Benutzer ein Menübandelement hervorhebt, das in einer Liste ist.
CMFCRibbonBaseElement::OnAddToQAToolbar	Fügt das Menübandelement der angegebenen Symbolleiste für den Schnellzugriff hinzu.
CMFCRibbonBaseElement::OnAfterChangeRect	Aktualisiert die QuickInfo für das Menübandelement.
CMFCRibbonBaseElement::OnAutoRepeat	Aktualisiert das Menübandelement als Reaktion auf einen längeren Benutzereingaben.
CMFCRibbonBaseElement::OnCalcTextSize	Berechnet die Textgröße für das Menübandelement.
CMFCRibbonBaseElement::OnChangeMenuHighlight	Aufgerufen vom Framework, wenn die Hervorhebung für ein Menübandelement ändern können, das in einem Menü ist.
CMFCRibbonBaseElement::OnDraw	Aufgerufen durch das Framework, um das Menübandelement zu zeichnen.
CMFCRibbonBaseElement::OnDrawKeyTip	Aufgerufen vom Framework, um das keytip für das Menübandelement zu zeichnen.
CMFCRibbonBaseElement::OnDrawMenuImage	Aufgerufen vom Framework, wenn das Menüimage für das Menübandelement gezeichnet wird.
CMFCRibbonBaseElement::OnDrawOnList	Aufgerufen durch das Framework, um das Menübandelement in einem Befehlslistenfeld zu zeichnen.
CMFCRibbonBaseElement::OnKey	Aufgerufen vom Framework, wenn der Benutzer drückt, hat ein keytip und das Menübandelement den Fokus.
CMFCRibbonBaseElement::OnMenuKey
CMFCRibbonBaseElement::OnRTLChanged	Aufgerufen vom Framework, wenn das Layout Richtung ändert.
CMFCRibbonBaseElement::OnShow	Aufgerufen durch das Framework, um das Menübandelement anzuzeigen oder auszublenden.
CMFCRibbonBaseElement::OnShowPopupMenu	Aufgerufen vom Framework, wenn das Menübandelement ein Popupmenü angezeigt wird.
CMFCRibbonBaseElement::PostMenuCommand
CMFCRibbonBaseElement::Redraw	Aktualisiert die Anzeige für das Menübandelement.
CMFCRibbonBaseElement::SetACCData	Legt die Barrierefreiheitsdaten für das Menübandelement fest.
CMFCRibbonBaseElement::SetCompactMode	Legt die Anzeigengröße für das Menübandelement fest.
CMFCRibbonBaseElement::SetData	Ordnet ein Datenelement mit dem Menübandelement zu.
CMFCRibbonBaseElement::SetDefaultMenuLook
CMFCRibbonBaseElement::SetDescription	Legt die Beschreibung für das Menübandelement fest.
CMFCRibbonBaseElement::SetID	Legt die Befehls-ID des Menübandelements fest.
CMFCRibbonBaseElement::SetInitialMode	Legt die ursprüngliche Anzeigengröße für das Menübandelement fest.
CMFCRibbonBaseElement::SetKeys	Legt ein keytip für das Menübandelement fest.
CMFCRibbonBaseElement::SetOriginal	Legt das ursprüngliche Menübandelement für das Menübandelement fest.
CMFCRibbonBaseElement::SetParentCategory	Legt die übergeordnete Kategorie für das Menübandelement fest.
CMFCRibbonBaseElement::SetParentMenu	Legt den Elementen Menücontainer für das Menübandelement fest.
CMFCRibbonBaseElement::SetParentRibbonBar	Legt die Elemente Menübandleiste für das Menübandelement fest.
CMFCRibbonBaseElement::SetRect	Legt die Dimensionen fest, fot, das er Rechteck für das Menübandelement anzeigt.
CMFCRibbonBaseElement::SetText	Legt den Text für das Menübandelement fest.
CMFCRibbonBaseElement::SetTextAlwaysOnRight	Legt den Text fest, damit das Menübandelement auf der rechten Seite anzeigt.
CMFCRibbonBaseElement::SetToolTipText	Legt den QuickInfo-Text für das Menübandelement fest.
CMFCRibbonBaseElement::SetVisible	Legt den Sichtbarkeitszustand des Menübandelements fest.
CMFCRibbonBaseElement::StretchHorizontally	Streckt die Breite des Menübandelements.
CMFCRibbonBaseElement::StretchToWholeRow	Ändert die Anzeigenhöhe des Menübandelements zur angegebenen Zeilenhöhe.
CMFCRibbonBaseElement::UpdateTooltipInfo	Aktualisiert den QuickInfo-Text mithilfe der Befehlsressource für das Menübandelement.

Geschützte Methoden

Name	Description
CMFCRibbonBaseElement::OnProcessKey	Aufgerufen vom Framework, wenn der Benutzer die Tastenkombination drückt.
CMFCRibbonBaseElement::OnSetFocus	Aufgerufen vom Framework ausgelöst, wenn ein Menübandelement den Eingabefokus erhält oder verliert.

Hinweise

Die CMFCRibbonBaseElement-Klasse definiert die Eigenschaften, die allen Menübandelementen gemeinsam sind, die Befehls-ID, Beschriftung, QuickInfo-Text, Elementbeschreibung und Zustand enthalten (der unten gerichtet werden kann, markiert werden, gedrückt werden, deaktiviert sind, überprüft oder abgelegt werden).

Die Größe eines Menübandelements wird vom RibbonImageType-Member definiert, der einer der folgenden Werte sein kann:

RibbonImageLarge
RibbonImageSmall

Je nach seiner Größe zeigt ein Menübandelement entweder ein kleines oder großes Bild an.

Beispiel

Das folgende Beispiel zeigt, wie verschiedene Methoden in der Klasse CMFCRibbonBaseElement verwendet.Im Beispiel wird gezeigt, wie ein CMFCRibbonBaseElement-Objekt aus einer Klasse CMFCRibbonStatusBar, legen Sie die Beschreibung für das Menübandelement, legen Sie den Text, legen Sie ein keytip und legen den QuickInfo-Text für das Menübandelement abruft.Dieser Codeausschnitt ist Teil Clientbeispiel Videofunktionen.

    // CMFCRibbonStatusBar m_wndStatusBar
    CMFCRibbonBaseElement* pPane = m_wndStatusBar.FindByID(nID);


...


        pPane->SetDescription(_T("a pane"));
        // CString strText
        pPane->SetText(strText);
        pPane->SetKeys(_T("p"));
        pPane->SetToolTipText(_T("this is a pane"));

Vererbungshierarchie

CObject

CMFCRibbonBaseElement

Anforderungen

Header: afxbaseribbonelement.h

Siehe auch

Referenz

Hierarchien-Diagramm

Weitere Ressourcen

MFC-Klassen

Freigeben über