RibbonDropDownItem Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Element in einer Dropdownliste in einem Menüband-Dropdown dar.
[System.Runtime.InteropServices.Guid("e715f92b-e5a0-434e-b8d2-9c43f4a6c0c2")]
public interface RibbonDropDownItem
- Attribute
Hinweise
Ein- RibbonDropDownItem Objekt enthält alle Daten, die erforderlich sind, um ein Element in einer Liste in RibbonComboBox , oder visuell darzustellen RibbonDropDown RibbonGallery . RibbonDropDownItemElemente haben eine Bezeichnung und optional ein zugeordnetes Bild. Sie können auch eine Bildschirm Spitze und eine erweiterte Bildschirm Info aufweisen, bei der es sich um Beschreibungen handelt, die angezeigt werden, wenn der Benutzer den Mauszeiger über ein Steuerelement bewegt.
Sie können einen RibbonDropDownItem zur Laufzeit erstellen, indem Sie die- CreateRibbonDropDownItem Methode des-Objekts verwenden RibbonFactory .
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.
Verwendung
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
| Id |
Ruft eine eindeutige Zeichenfolge ab, die von Microsoft Office zum Identifizieren dieses RibbonDropDownItem verwendet wird. |
| Image |
Ruft das in RibbonDropDownItem angezeigte Bild ab oder legt es fest. |
| Label |
Ruft den von diesem RibbonDropDownItem angezeigten Text ab oder legt ihn fest. |
| OfficeImageId |
Ruft das Bild ab, das für RibbonDropDownItem angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten, oder legt das Bild fest. |
| Parent |
Ruft die RibbonComponent ab, zu der das RibbonDropDownItem gehört. |
| Ribbon |
Ruft das Ribbon-Objekt der obersten Ebene ab, das die restliche Hierarchie der Steuerelemente enthält. |
| ScreenTip |
Ruft Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonDropDownItem richtet, oder legt diesen fest. |
| SuperTip |
Ruft mehrzeiligen Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonDropDownItem richtet, oder legt diesen fest. |
| Tag |
Ruft anwendungsspezifische Daten ab, die diesem RibbonDropDownItem zugeordnet sind, oder legt diese fest. |