RibbonBox 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.
Ordnet Steuerelemente auf einem benutzerdefinierten Menüband an, und richtet sie aus.
[System.Runtime.InteropServices.Guid("e351eac0-961f-458a-8811-58090e3198ef")]
public interface RibbonBox : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
- Attribute
- Implementiert
Hinweise
Passt die Menüband-Steuerelemente automatisch an, wenn Sie auf dem Steuerelement abgelegt werden RibbonBox .
Verwenden Sie die- BoxStyle Eigenschaft, um untergeordnete Steuerelemente horizontal (Standard) oder vertikal anzuordnen. Wenn Steuerelemente so festgelegt sind, dass Sie vertikal angeordnet werden und nicht genügend Speicherplatz vorhanden ist, werden Sie in mehreren Spalten angeordnet.
Einige Eigenschaften dieses Steuer Elements können nur festgelegt werden, bevor das Menüband in die Office-Anwendung geladen wird. Weitere Informationen zum Festlegen dieser Eigenschaften finden Sie unter Übersicht über das Menüband-Objektmodell.
Sie können einen RibbonBox zur Laufzeit erstellen, indem Sie die- CreateRibbonBox 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
| BoxStyle |
Ruft einen RibbonBoxStyle-Wert ab, der angibt, ob für das RibbonBox platzierte Steuerelemente horizontal oder vertikal angeordnet werden. |
| 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) |
| Items |
Ruft eine Auflistung der Steuerelemente in diesem RibbonBox-Objekt ab. |
| Name |
Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Geerbt von RibbonComponent) |
| 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 |
| 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 |
| PerformLayout() |
Ruft die |
| 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) |