RibbonDropDownItem-Schnittstelle

Artikel
08/10/2011

Stellt ein Element in einer Dropdownliste in einem Menüband-Dropdownsteuerelement dar.

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

Syntax

'Declaration
<GuidAttribute("e715f92b-e5a0-434e-b8d2-9c43f4a6c0c2")> _
Public Interface RibbonDropDownItem

[GuidAttribute("e715f92b-e5a0-434e-b8d2-9c43f4a6c0c2")]
public interface RibbonDropDownItem

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

Eigenschaften

	Name	Beschreibung
	Id	Ruft eine eindeutige Zeichenfolge ab, die von Microsoft Office zum Identifizieren dieses RibbonDropDownItem verwendet wird.
	Image	Ruft ein in RibbonDropDownItem dargestelltes Bild ab oder legt dieses fest.
	Label	Ruft den von RibbonDropDownItem angezeigten Text ab oder legt diesen fest.
	OfficeImageId	Ruft das Bild ab bzw. legt das Bild fest, das für RibbonDropDownItem angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten.
	Parent	Ruft die RibbonComponent ab, zu der RibbonDropDownItem gehört.
	Ribbon	Ruft das Ribbon-Objekt auf der obersten Ebene ab, das den Rest der Steuerelementhierarchie beinhaltet.
	ScreenTip	Ruft Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger über RibbonDropDownItem richtet, oder legt diesen fest.
	SuperTip	Ruft mehrzeiligen Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf RibbonDropDownItem richtet, oder legt diesen fest.
	Tag	Ruft anwendungsspezifische Daten ab, die diesem RibbonDropDownItem zugeordnet sind, oder legt diese fest.

Zum Seitenanfang

Hinweise

Ein RibbonDropDownItem-Objekt beinhaltet alle Daten, die zur visuellen Darstellung eines Elements in einer Liste in RibbonComboBox, RibbonDropDown oder RibbonGallery erforderlich sind. RibbonDropDownItem-Elemente haben eine Bezeichnung und optional ein zugeordnetes Bild. Die Elemente können auch über eine QuickInfo oder eine erweiterte QuickInfo verfügen, wobei es sich jeweils um Beschreibungen handelt, die angezeigt werden, wenn der Benutzer den Mauszeiger über ein Steuerelement hält.

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

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.

Verwendung

In dieser Dokumentation wird die Version dieses Typs beschrieben, der in Office-Projekten mit der Zielversion .NET Framework 4 verwendet wird. In Projekten mit der Zielversion .NET Framework 3.5 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.