RibbonFactory-Schnittstelle

  • Artikel

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
Assemblys:   Microsoft.Office.Tools.Common.v4.0.Utilities (in Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
  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
Öffentliche Eigenschaft 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
Öffentliche Methode _VtblGap1_19
Öffentliche Methode CreateOfficeRibbon Erstellt ein OfficeRibbon-Objekt, das eine Menübandanpassung darstellt.
Öffentliche Methode CreateRibbonBox Erstellt ein RibbonBox-Objekt, das Steuerelemente auf einem benutzerdefinierten Menüband anordnet und ausrichtet.
Öffentliche Methode CreateRibbonButton Ein RibbonButton stellt eine Schaltfläche auf einem benutzerdefinierten Menüband dar.
Öffentliche Methode CreateRibbonButtonGroup Erstellt ein RibbonButtonGroup-Objekt, das eine Gruppe von Schaltflächen auf einem Menüband darstellt.
Öffentliche Methode CreateRibbonCheckBox Erstellt ein RibbonCheckBox-Objekt, das ein Kontrollkästchen auf einem Menüband darstellt.
Öffentliche Methode CreateRibbonComboBox Erstellt ein RibbonComboBox-Objekt, das ein Kombinationsfeld auf einem benutzerdefinierten Menüband darstellt.
Öffentliche Methode CreateRibbonDialogLauncher Erstellt ein RibbonDialogLauncher-Objekt, das ein kleines standardisiertes Symbol für eine Gruppe darstellt, mit dem ein Dialogfeld geöffnet werden kann.
Öffentliche Methode 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.
Öffentliche Methode CreateRibbonDropDownItem Erstellt ein RibbonDropDownItem-Objekt, das ein Element in einem Dropdownsteuerelement darstellt.
Öffentliche Methode CreateRibbonEditBox Erstellt ein RibbonEditBox-Objekt, das ein Eingabefeld auf einem Menüband darstellt.
Öffentliche Methode CreateRibbonGallery Erstellt ein RibbonGallery-Objekt, das ein Steuerelement darstellt, das ein Menü von RibbonDropDownItem-Objekten und RibbonButton-Steuerelementen anzeigt.
Öffentliche Methode CreateRibbonGroup Erstellt eine RibbonGroup, die eine Gruppe der Steuerelemente auf einer Menüband-Registerkarte darstellt.
Öffentliche Methode CreateRibbonLabel Erstellt ein RibbonLabel, das eine Bezeichnung in einer RibbonGroup oder RibbonBox darstellt.
Öffentliche Methode CreateRibbonManager Erstellt ein IRibbonExtensibility-Objekt, das eine Menübandanpassung darstellt.
Öffentliche Methode CreateRibbonMenu Erstellt ein RibbonMenu, das ein Menü auf einer Menübandregisterkarte oder im Microsoft Office-Menü darstellt.
Öffentliche Methode CreateRibbonReadOnlyCollection Erstellt ein RibbonMenu-Objekt, das Zugriff auf die IRibbonExtension-Objekte in einer Menübandanpassung bereitstellt.
Öffentliche Methode CreateRibbonSeparator Erstellt ein RibbonSeparator-Objekt, das ein Separator-Steuerelement für eine Gruppe oder ein Menü im Menüband darstellt.
Öffentliche Methode CreateRibbonSplitButton Erstellt ein RibbonSplitButton-Objekt, das eine Schaltfläche bzw. eine Umschaltfläche und ein Dropdownmenü vereint.
Öffentliche Methode CreateRibbonTab Erstellt ein RibbonTab-Objekt, das eine oder mehrere Gruppen von Steuerelementen auf dem Menüband enthält.
Öffentliche Methode CreateRibbonToggleButton Erstellt einen RibbonToggleButton, der ein Umschaltflächensteuerelement auf einem Menüband darstellt.

Zum Seitenanfang

Hinweise

HinweisHinweis

Diese Schnittstelle wird von der Visual Studio-Tools für 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