RibbonDropDown-Schnittstelle

Artikel
05/07/2013

Stellt eine Liste von Elementen dar, die ein Benutzer auswählen kann, sowie eine Liste von Menübandschaltflächen, auf die ein Benutzer klicken kann.

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

Syntax

'Declaration
<GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")> _
Public Interface RibbonDropDown _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

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

Eigenschaften

	Name	Beschreibung
	Buttons	Ruft eine Auflistung von RibbonButton-Objekten ab, die zu diesem RibbonDropDown gehören.
	Enabled	Ruft einen Wert ab, der angibt, ob RibbonControl aktiviert ist, oder legt diesen fest. (Von RibbonControl geerbt.)
	Id	Ruft eine Zeichenfolge ab, die von Microsoft Office zum Identifizieren dieses RibbonControl-Objekts verwendet wird. (Von RibbonControl geerbt.)
	Image	Ruft ein in RibbonDropDown dargestelltes Bild ab oder legt dieses fest.
	ImageName	Ruft den Namen ab oder legt den Namen fest, den Sie im LoadImage-Ereignishandler zum Identifizieren eines Bilds für das Steuerelement verwenden können.
	Items	Ruft eine Auflistung der Elemente in diesem RibbonDropDown ab.
	KeyTip	Ruft die Tastenkombination für diesen RibbonDropDown ab oder legt diese fest.
	Label	Ruft den Text ab oder legt den Text fest, der in RibbonDropDown angezeigt wird.
	Name	Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Von RibbonComponent geerbt.)
	OfficeImageId	Ruft das Bild ab bzw. legt das Bild fest, das für RibbonDropDown angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten.
	Parent	Ruft eine RibbonComponent ab, die die übergeordnete Komponente von RibbonComponent darstellt. (Von RibbonComponent geerbt.)
	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.)
	ScreenTip	Ruft Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf RibbonDropDown richtet, oder legt diesen fest.
	SelectedItem	Ruft das derzeit ausgewählte RibbonDropDownItem ab oder legt dieses fest.
	SelectedItemIndex	Ruft den Index des derzeit ausgewählten RibbonDropDownItem ab oder legt diesen fest.
	ShowImage	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das RibbonDropDown zugeordnete Bild sichtbar ist.
	ShowItemImage	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob Bilder für die Elemente im Dropdownmenü angezeigt werden.
	ShowItemLabel	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob Bezeichnungen für die Elemente im Dropdownmenü angezeigt werden.
	ShowLabel	Ruft einen Wert ab, der angibt, ob die Bezeichnung dieses RibbonDropDown sichtbar ist, oder legt diesen fest.
	Site	Ruft den dem IComponent zugeordneten ISite ab oder legt diesen fest. (Von IComponent geerbt.)
	SizeString	Ruft eine Zeichenfolge ab, durch die die Größe von RibbonDropDown bestimmt wird, oder legt diese fest.
	SuperTip	Ruft mehrzeiligen Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf RibbonDropDown richtet, oder legt diesen fest.
	Tag	Ruft anwendungsspezifische Daten ab, die RibbonComponent zugeordnet sind, oder legt diese fest. (Von RibbonComponent geerbt.)
	Visible	Ruft einen Wert ab, der angibt, ob RibbonControl sichtbar ist, oder legt diesen fest. (Von RibbonControl geerbt.)

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
	ButtonClick	Tritt auf, wenn ein Benutzer auf eine Schaltfläche in RibbonDropDown klickt.
	Disposed	Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)
	ItemsLoading	Tritt auf, wenn Steuerelemente in RibbonDropDown geladen werden.
	SelectionChanged	Tritt auf, wenn ein Benutzer in einem Dropdownsteuerelement des Menübands ein neues Element auswählt.

Zum Seitenanfang

Hinweise

RibbonDropDown kann RibbonDropDownItem-Objekte und RibbonButton-Steuerelemente beinhalten.

Sie können zur Laufzeit eine RibbonDropDown erstellen, indem Sie die CreateRibbonDropDown-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.

Sie können keine Schaltflächen während der Laufzeit zur Buttons-Auflistung hinzufügen, nachdem das Menüband in die Office-Anwendung geladen wurde.

Nachfolgend finden Sie Erläuterungen zum Hinzufügen von RibbonDropDownItem-Objekten und RibbonButton-Steuerelementen zu RibbonDropDown.

So fügen Sie während der Entwurfszeit RibbonDropDownItem-Objekte hinzu

Klicken Sie im Fenster Eigenschaften auf die Items-Eigenschaft.
Klicken Sie auf die Ellipse (…).
Im Dropdownauflistungs-Editor werden neue Elemente hinzugefügt, sortiert und bearbeitet.

Sie können RibbonDropDown während der Entwurfszeit RibbonButton-Steuerelemente hinzufügen.

So fügen Sie während der Entwurfszeit RibbonButton-Steuerelemente hinzu

Klicken Sie im Fenster Eigenschaften auf die Buttons-Eigenschaft.
Klicken Sie auf die Ellipse (…).
Im Schaltflächenauflistungs-Editor werden neue Schaltflächensteuerelemente hinzugefügt, sortiert und bearbeitet.

Einige Member dieses Typs können nur vor dem Laden des Menübands in die Office-Anwendung festgelegt werden.Informationen zum Festlegen dieser Eigenschaften finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

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.