RibbonGroup Schnittstelle

Definition

Namespace:

Microsoft.Office.Tools.Ribbon

Assembly:

Microsoft.Office.Tools.Common.dll

Stellt eine Gruppe von Steuerelementen auf einer Registerkarte des Menübands dar.

public interface class RibbonGroup : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")>]
type RibbonGroup = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent

Attribute

GuidAttribute

Implementiert

RibbonComponent IComponent IDisposable

Hinweise

Visual Studio erstellt ein RibbonGroup -Objekt, wenn Sie ein Group-Steuerelement von der Registerkarte Steuerelemente des Office-Menübands der Toolbox auf das Menüband Designer ziehen.

Allgemeine Aufgaben

In der folgenden Tabelle sind Elemente aufgeführt, die für allgemeine Aufgaben nützlich sind. Alle diese Aufgaben können zur Entwurfszeit ausgeführt werden. Einige dieser Aufgaben können zur Laufzeit ausgeführt werden, bevor das Menüband geladen wird. Weitere Informationen finden Sie unter Übersicht über das Menübandobjektmodell.

Aufgabe	Mitglied
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 Registerkarte im Menüband eine Gruppe hinzu.	Fügen Sie der Auflistung der Groups Registerkarte einen RibbonGroup 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 eine RibbonGroup zur Laufzeit 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 Visual Studio Tools for Office Runtime Overview.

Verbrauch

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und höher 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. Eine Dokumentation dieser Art von Projekten, die auf den .NET Framework 3.5 abzielen, erhalten Sie in den folgenden Verweisabschnitten in der Dokumentation zu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Eigenschaften

DialogLauncher	Ruft das Dialogfeld-Startprogramm des Menübands ab, das der Gruppe zugeordnet ist, oder legt es fest.
Id	Ruft eine Zeichenfolge ab, die die aktuelle Gruppe bezeichnet.
Items	Ruft die Steuerelemente in der Gruppe ab.
KeyTip	Ruft die Tastenkombination der Gruppe ab oder legt sie fest.
Label	Ruft den Text ab, der von der Bezeichnung der Gruppe angezeigt wird, oder legt diesen fest.
Name	Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Geerbt von RibbonComponent)
Parent	Ruft ein RibbonComponent ab, das das übergeordnete Element von RibbonComponent darstellt. (Geerbt von RibbonComponent)
Position	Ruft die Position einer Gruppe auf einer integrierten Registerkarte relativ zu einer integrierten Gruppe auf der Registerkarte ab oder legt sie fest.
Ribbon	Ruft das Ribbon-Objekt der obersten Ebene ab, das die Hierarchie der Steuerelemente enthält. (Geerbt von RibbonComponent)
RibbonUI	Ruft die IRibbonUI-Instanz ab, die von der Microsoft Office-Anwendung für den Erweiterbarkeitscode des Menübands bereitgestellt wird. (Geerbt von RibbonComponent)
Tag	Ruft anwendungsspezifische Daten ab, die diesem RibbonComponent zugeordnet sind, oder legt diese fest. (Geerbt von RibbonComponent)
Visible	Ruft einen Wert ab, der angibt, ob die Gruppe sichtbar ist, oder legt einen Wert fest.

Methoden

PerformDynamicLayout()	Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode des übergeordneten Steuerelements auf, wenn die RibbonComponent-Schnittstelle über ein dynamisches übergeordnetes Element verfügt (z.B. ein dynamisches Menü), und das Layout nicht angehalten wird. (Geerbt von RibbonComponent)
PerformLayout()	Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode auf, wenn RibbonComponent über ein übergeordnetes Element verfügt und das Layout nicht angehalten wird. (Geerbt von RibbonComponent)
ResumeLayout()	Kehrt den Effekt der SuspendLayout()-Methode um. (Geerbt von RibbonComponent)
ResumeLayout(Boolean)	Kehrt den Effekt der SuspendLayout()-Methode um. (Geerbt von RibbonComponent)
SuspendLayout()	Hindert die Microsoft Office-Anwendung am Aktualisieren des Zustands der Steuerelemente auf dem Menüband. (Geerbt von RibbonComponent)

Ereignisse

DialogLauncherClick

Tritt auf, wenn der Benutzer in der Gruppe auf das Symbol für das Menüband „Dialogfeld-Startprogramm“ klickt.