RibbonComboBox-Schnittstelle
Stellt ein Kombinationsfeld auf einem benutzerdefinierten Menüband dar.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Syntax
'Declaration
<GuidAttribute("97074be3-d4bb-4923-881a-7a6e225738af")> _
Public Interface RibbonComboBox _
Inherits RibbonControl, RibbonComponent, IComponent, IDisposable
[GuidAttribute("97074be3-d4bb-4923-881a-7a6e225738af")]
public interface RibbonComboBox : RibbonControl,
RibbonComponent, IComponent, IDisposable
Der RibbonComboBox-Typ macht die folgenden Member verfügbar.
Eigenschaften
Name | Beschreibung | |
---|---|---|
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 RibbonComboBox 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 RibbonComboBox ab. | |
KeyTip | Ruft die Tastenkombination für RibbonComboBox ab oder legt diese fest. | |
Label | Ruft den Text ab oder legt den Text fest, der in RibbonComboBox angezeigt wird. | |
MaxLength | Ruft einen Wert ab oder legt einen Wert fest, der die maximale Anzahl der pro Eintrag in diesem RibbonComboBox zulässigen Zeichen angibt. | |
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 RibbonComboBox 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 über RibbonComboBox richtet, oder legt diesen fest. | |
ShowImage | Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das RibbonComboBox 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. | |
ShowLabel | Ruft einen Wert ab, der angibt, ob die Bezeichnung von RibbonComboBox sichtbar ist, oder legt diesen fest. | |
Site | Ruft die ISite ab, die IComponent zugeordnet ist, oder legt diese fest. (Von IComponent geerbt.) | |
SizeString | Ruft eine Zeichenfolge ab, durch die die Größe von RibbonComboBox bestimmt wird, oder legt diese fest. | |
SuperTip | Ruft mehrzeiligen Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf RibbonComboBox richtet, oder legt diesen fest. | |
Tag | Ruft anwendungsspezifische Daten ab, die RibbonComponent zugeordnet sind, oder legt diese fest. (Von RibbonComponent geerbt.) | |
Text | Ruft den Text ab oder legt den Text fest, der in RibbonComboBox angezeigt wird. | |
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 | |
---|---|---|
Disposed | Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.) | |
ItemsLoading | Tritt auf, wenn die Dropdownliste für RibbonComboBox geöffnet ist. | |
TextChanged | Tritt ein, wenn ein Benutzer den Text in RibbonComboBox ändert. |
Zum Seitenanfang
Hinweise
Ein Kombinationsfeld beinhaltet ein Texteingabefeld und eine Liste der Optionen in einem Dropdownmenü.
Sie können zur Laufzeit eine RibbonComboBox erstellen, indem Sie die CreateRibbonComboBox-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.
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.
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.
Siehe auch
Referenz
Microsoft.Office.Tools.Ribbon-Namespace
Weitere Ressourcen
Übersicht über die Multifunktionsleiste
Multifunktionsleisten-Designer
Multifunktionsleisten-Objektmodellübersicht
Gewusst wie: Erste Schritte beim Anpassen der Multifunktionsleiste