RibbonDropDown 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 eine Liste von Elementen dar, aus denen Benutzer auswählen können, sowie eine Liste von Menübandschaltflächen, auf die ein Benutzer klicken kann.
public interface class RibbonDropDown : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
interface RibbonControl
interface RibbonComponent
interface IComponent
interface IDisposable
Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl
- Attribute
- Implementiert
Hinweise
Ein RibbonDropDown kann Objekte und RibbonButton Steuerelemente enthaltenRibbonDropDownItem.
Sie können eine RibbonDropDown zur Laufzeit 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 der Buttons Sammlung zur Laufzeit keine Schaltflächen hinzufügen, nachdem das Menüband in Office geladen wurde.
In den folgenden Prozeduren wird erläutert, wie Einem Objekte und RibbonButton Steuerelemente hinzugefügt RibbonDropDownItem werdenRibbonDropDown.
So fügen Sie RibbonDropDownItem-Objekte zur Entwurfszeit hinzu
Klicken Sie im Eigenschaftenfenster auf die Eigenschaft Items.
Klicken Sie auf die Auslassungspunkte (...).
Fügen Sie im DropDown Collection-Editor neue Elemente hinzu, ordnen Sie sie an und bearbeiten Sie sie.
Sie können steuerelemente RibbonDropDown zur Entwurfszeit hinzufügenRibbonButton.
So fügen Sie RibbonButton-Steuerelemente zur Entwurfszeit hinzu
Klicken Sie im Eigenschaftenfenster auf die Eigenschaft Schaltflächen.
Klicken Sie auf die Auslassungspunkte (...).
Fügen Sie im Editor Schaltflächensammlung neue Schaltflächensteuerelemente hinzu, ordnen Sie sie an und bearbeiten Sie sie.
Einige Member dieses Typs können nur festgelegt werden, bevor das Menüband in die Office-Anwendung geladen wird. Informationen zum Festlegen dieser Eigenschaften finden Sie unter Übersicht über das Menübandobjektmodell.
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
Buttons |
Ruft eine Auflistung von RibbonButton-Objekten ab, die zu RibbonDropDown gehören. |
Enabled |
Ruft einen Wert ab, der angibt, ob das RibbonControl aktiviert ist, oder legt einen Wert fest. (Geerbt von RibbonControl) |
Id |
Ruft eine Zeichenfolge ab, die Microsoft Office zum Identifizieren dieses RibbonControl-Objekts verwendet. (Geerbt von RibbonControl) |
Image |
Ruft das in RibbonDropDown angezeigte Bild ab oder legt es 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 in RibbonDropDown enthaltenen Elemente ab. |
KeyTip |
Ruft die Tastenkombination für dieses RibbonDropDown ab oder legt sie fest. |
Label |
Ruft den Text ab, der in einem Menü auf RibbonDropDown angezeigt wird, oder legt diesen fest. |
Name |
Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Geerbt von RibbonComponent) |
OfficeImageId |
Ruft das Bild ab, das für RibbonDropDown angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten, oder legt das Bild fest. |
Parent |
Ruft ein RibbonComponent ab, das das übergeordnete Element von RibbonComponent darstellt. (Geerbt von RibbonComponent) |
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) |
ScreenTip |
Ruft Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonDropDown richtet, oder legt diesen fest. |
SelectedItem |
Ruft das RibbonDropDownItem ab, das aktuell ausgewählt ist, oder legt es 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, der angibt, ob Bilder für die Elemente im Dropdownmenü angezeigt werden, oder legt diesen Wert fest. |
ShowItemLabel |
Ruft einen Wert ab, der angibt, ob Bezeichnungen für die Elemente im Dropdownmenü angezeigt werden, oder legt diesen Wert fest. |
ShowLabel |
Ruft einen Wert ab, der angibt, ob die Bezeichnung für dieses RibbonDropDown sichtbar ist, oder legt diesen Wert fest. |
SizeString |
Ruft eine Zeichenfolge ab, die die Größe des RibbonDropDown bestimmt, oder legt diese fest. |
SuperTip |
Ruft mehrzeiligen Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonDropDown richtet, oder legt diesen fest. |
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 das RibbonControl sichtbar ist, oder legt den Wert fest. (Geerbt von RibbonControl) |
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
ButtonClick |
Tritt auf, wenn ein Benutzer auf eine Schaltfläche unter RibbonDropDown klickt. |
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. |