RibbonGroup-Schnittstelle

Artikel
05/07/2013

Stellt eine Gruppe von Steuerelementen auf einer Menübandregisterkarte dar.

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

Syntax

'Declaration
<GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

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

Eigenschaften

	Name	Beschreibung
	DialogLauncher	Ruft das der Gruppe zugeordnete Dialogfeldstartprogramm für das Menüband ab oder legt es fest.
	Id	Ruft eine Zeichenfolge ab, die die aktuelle Gruppe angibt.
	Items	Ruft die Steuerelemente in der Gruppe ab.
	KeyTip	Ruft die Tastenkombination der Gruppe ab oder legt sie fest.
	Label	Ruft den in der Bezeichnung der Gruppe angezeigten Text ab oder legt diesen fest.
	Name	Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Von RibbonComponent geerbt.)
	Parent	Ruft eine RibbonComponent ab, die die übergeordnete Komponente von RibbonComponent darstellt. (Von RibbonComponent geerbt.)
	Position	Ruft die Position einer Gruppe auf einer integrierten Registerkarte relativ zur integrierten Gruppe auf der Registerkarte ab bzw. legt sie fest.
	Ribbon	Ruft das Ribbon-Objekt auf der obersten Ebene ab, das die Steuerelementhierarchie beinhaltet. (Von RibbonComponent geerbt.)
	RibbonUI	Infrastruktur. Ruft die IRibbonUI-Instanz ab, die von der Microsoft Office-Anwendung für den Erweiterbarkeitscode des Menübands bereitgestellt wird. (Von RibbonComponent geerbt.)
	Site	Ruft den dem IComponent zugeordneten ISite ab oder legt diesen fest. (Von IComponent geerbt.)
	Tag	Ruft anwendungsspezifische Daten ab, die RibbonComponent zugeordnet sind, oder legt diese fest. (Von RibbonComponent geerbt.)
	Visible	Ruft einen Wert ab, der angibt, ob die Gruppe angezeigt wird, oder legt diesen fest.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Dispose	Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
	PerformDynamicLayout	Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode des übergeordneten Steuerelements ab, wenn die RibbonComponent über ein dynamisches übergeordnetes Element, z. B. ein dynamisches Menü, verfügt; das Layout wird nicht gesperrt. (Von RibbonComponent geerbt.)
	PerformLayout	Ruft Microsoft.Office.Core.IRibbonUI.InvalidateControl auf, falls RibbonComponent über ein übergeordnetes Element verfügt und das Layout nicht angehalten wurde. (Von RibbonComponent geerbt.)
	ResumeLayout()	Kehrt den Effekt der SuspendLayout-Methode um. (Von RibbonComponent geerbt.)
	ResumeLayout(Boolean)	Kehrt den Effekt der SuspendLayout-Methode um. (Von RibbonComponent geerbt.)
	SuspendLayout	Hindert die Microsoft Office-Anwendung am Aktualisieren des Zustands der Steuerelemente auf dem Menüband. (Von RibbonComponent geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	DialogLauncherClick	Tritt auf, wenn der Benutzer in der Gruppe auf das Symbol des Dialogfeldstartprogramms für das Menüband klickt.
	Disposed	Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)

Zum Seitenanfang

Hinweise

Visual Studio erstellt ein RibbonGroup-Objekt, wenn Sie ein Group-Steuerelement von der Registerkarte Steuerelemente für Office-Menübänder der Toolbox auf den Menüband-Designer ziehen.

Allgemeine Aufgaben

In der folgenden Tabelle werden Member aufgeführt, die nützlich bei allgemeinen Aufgaben sind.Alle diese Aufgaben können während der Entwurfszeit ausgeführt werden.Einige dieser Aufgaben können vor dem Laden des Menübands während der Laufzeit ausgeführt werden.Weitere Informationen finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

Aufgabe	Member
Greifen Sie auf die Steuerelemente in der Gruppe zu, fügen Sie der Gruppe Steuerelemente hinzu, oder entfernen Sie Steuerelemente aus der Gruppe.	Verwenden Sie die Items-Eigenschaft.
Fügen Sie einer Menübandregisterkarte eine Gruppe hinzu.	Fügen Sie ein RibbonGroup zur Groups-Auflistung der Registerkarte hinzu.
Geben Sie den Speicherort einer Gruppe auf einer integrierten Registerkarte relativ zum Speicherort einer integrierten Gruppe an.	Verwenden Sie die Position-Eigenschaft.

Sie können zur Laufzeit eine RibbonGroup erstellen, indem Sie die CreateRibbonGroup-Methode des RibbonFactory-Objekts verwenden.

Es gibt zwei Möglichkeiten, um auf das RibbonFactory-Objekt zuzugreifen:

Mithilfe der Factory-Eigenschaft der Ribbon-Klasse.Verwenden Sie diesen Ansatz aus Code in der Ribbon-Klasse.
Mithilfe der Globals.Factory.GetRibbonFactory-Methode.Verwenden Sie diesen Ansatz aus Code außerhalb der Ribbon-Klasse.

Hinweis
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.

Verwendung

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und .NET Framework 4.5 ausgerichtet sind. In Projekten, die auf .NET Framework 3.5 abzielen, verfügt dieser Typ möglicherweise über unterschiedliche Member, und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Dokumentation zu diesem Typ in Projekten mit der Zielversion .NET Framework 3.5 finden Sie im folgenden Verweisabschnitt in der Visual Studio 2008-Dokumentation: https://go.microsoft.com/fwlink/?LinkId=160658.