RibbonFactory-Schnittstelle

Stellt Methoden bereit, mit denen Sie Menüband-Steuerelemente für die Anpassung eines Microsoft Office-Menübands erstellen können.

Namespace:  Microsoft.Office.Tools.Ribbon
Assembly:  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

'Declaration
<GuidAttribute("1012BDD2-303F-4464-A64B-3026BD91C31E")> _
<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)> _
Public Interface RibbonFactory

[GuidAttribute("1012BDD2-303F-4464-A64B-3026BD91C31E")]
[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)]
public interface RibbonFactory

Der RibbonFactory-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	RibbonPosition	Ruft ein RibbonPositionStatics-Objekt ab, mit dem Sie die Position eines Steuerelements, einer Gruppe oder einer Registerkarte in einer Menübandanpassung angeben können.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	CreateOfficeRibbon	Erstellt ein OfficeRibbon-Objekt, das eine Menübandanpassung darstellt.
	CreateRibbonBox	Erstellt ein RibbonBox-Objekt, das Steuerelemente auf einem benutzerdefinierten Menüband anordnet und ausrichtet.
	CreateRibbonButton	Ein RibbonButton stellt eine Schaltfläche auf einem benutzerdefinierten Menüband dar.
	CreateRibbonButtonGroup	Erstellt ein RibbonButtonGroup-Objekt, das eine Gruppe von Schaltflächen auf einem Menüband darstellt.
	CreateRibbonCheckBox	Erstellt ein RibbonCheckBox-Objekt, das ein Kontrollkästchen auf einem Menüband darstellt.
	CreateRibbonComboBox	Erstellt ein RibbonComboBox-Objekt, das ein Kombinationsfeld auf einem benutzerdefinierten Menüband darstellt.
	CreateRibbonDialogLauncher	Erstellt ein RibbonDialogLauncher-Objekt, das ein kleines standardisiertes Symbol für eine Gruppe darstellt, mit dem ein Dialogfeld geöffnet werden kann.
	CreateRibbonDropDown	Erstellt ein RibbonDropDown-Objekt, das eine Liste von Elementen darstellt, die ein Benutzer auswählen kann, sowie eine Liste von Menüband-Schaltflächen, auf die ein Benutzer klicken kann.
	CreateRibbonDropDownItem	Erstellt ein RibbonDropDownItem-Objekt, das ein Element in einem Dropdownsteuerelement darstellt.
	CreateRibbonEditBox	Erstellt ein RibbonEditBox-Objekt, das ein Eingabefeld auf einem Menüband darstellt.
	CreateRibbonGallery	Erstellt ein RibbonGallery-Objekt, das ein Steuerelement darstellt, das ein Menü von RibbonDropDownItem-Objekten und RibbonButton-Steuerelementen anzeigt.
	CreateRibbonGroup	Erstellt eine RibbonGroup, die eine Gruppe der Steuerelemente auf einer Menüband-Registerkarte darstellt.
	CreateRibbonLabel	Erstellt ein RibbonLabel, das eine Bezeichnung in einer RibbonGroup oder RibbonBox darstellt.
	CreateRibbonManager	Erstellt ein IRibbonExtensibility-Objekt, das eine Menübandanpassung darstellt.
	CreateRibbonMenu	Erstellt ein RibbonMenu, das ein Menü auf einer Menübandregisterkarte oder im Microsoft Office-Menü darstellt.
	CreateRibbonReadOnlyCollection	Erstellt ein RibbonMenu-Objekt, das Zugriff auf die IRibbonExtension-Objekte in einer Menübandanpassung bereitstellt.
	CreateRibbonSeparator	Erstellt ein RibbonSeparator-Objekt, das ein Separator-Steuerelement für eine Gruppe oder ein Menü im Menüband darstellt.
	CreateRibbonSplitButton	Erstellt ein RibbonSplitButton-Objekt, das eine Schaltfläche bzw. eine Umschaltfläche und ein Dropdownmenü vereint.
	CreateRibbonTab	Erstellt ein RibbonTab-Objekt, das eine oder mehrere Gruppen von Steuerelementen auf dem Menüband enthält.
	CreateRibbonToggleButton	Erstellt einen RibbonToggleButton, der ein Umschaltflächensteuerelement auf einem Menüband darstellt.

Zum Seitenanfang

Hinweise

Tipp

Diese Schnittstelle wird von der Visual Studio Tools for Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Übersicht über die Visual Studio Tools for Office-Laufzeit.

Beispiele

Das folgende Beispiel greift auf die RibbonFactory-Instanz des Projekts in der Menüband-Codedatei eines Excel 2010-Arbeitsmappenprojekts zu. Dieser Code erstellt mithilfe von Methoden im RibbonFactory-Objekt ein Dropdownelement, ein Menü und eine Schaltfläche. Das vollständige Beispiel finden Sie unter Exemplarische Vorgehensweise: Aktualisieren der Steuerelemente in einer Multifunktionsleiste zur Laufzeit.

Private Function CreateRibbonDropDownItem() As RibbonDropDownItem
    Return Me.Factory.CreateRibbonDropDownItem()
End Function

Private Function CreateRibbonMenu() As RibbonMenu
    Return Me.Factory.CreateRibbonMenu()
End Function

Private Function CreateRibbonButton() As RibbonButton
    Dim button As RibbonButton = Me.Factory.CreateRibbonButton()
    AddHandler (button.Click), AddressOf Button_Click
    Return button
End Function

private RibbonDropDownItem CreateRibbonDropDownItem()
{
    return this.Factory.CreateRibbonDropDownItem();
}
private RibbonMenu CreateRibbonMenu()
{
    return this.Factory.CreateRibbonMenu();
}
private RibbonButton CreateRibbonButton()
{
    RibbonButton button = this.Factory.CreateRibbonButton();
    button.Click += new RibbonControlEventHandler(button_Click);
    return button;
}

Siehe auch

Referenz

Microsoft.Office.Tools.Ribbon-Namespace