RibbonGallery Schnittstelle

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Ribbon

Assembly:: Microsoft.Office.Tools.Common.dll

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 Steuerelement dar, in dem ein Menü von RibbonDropDownItem-Objekten und RibbonButton-Steuerelementen angezeigt wird.

public interface class RibbonGallery : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

Attribute: GuidAttribute

Implementiert: RibbonComponent RibbonControl IComponent IDisposable

Hinweise

Zeigt wie die RibbonDropDown Benutzeroberfläche RibbonGallery ein Menü mit Objekten und RibbonButton Steuerelementen RibbonDropDownItem an.

RibbonDropDown Im Gegensatz zur Schnittstelle löst die RibbonGallery Schnittstelle Ereignisse anstelle SelectionChanged von Ereignissen ausClick, wenn ein Benutzer auf eine RibbonDropDownItemklickt. Dies bedeutet beispielsweise, dass das Click Ereignis zweimal ausgelöst wird, wenn ein Benutzer zweimal auf dasselbe RibbonDropDownItem klickt. (Das SelectionChanged Ereignis wird höchstens einmal ausgelöst, wenn die anfängliche Auswahl für dasselbe Szenario für ein RibbonDropDowngetroffen wurde, je nachdem, was die Auswahl vor dem ersten Klick war.)

Die ShowItemSelection -Eigenschaft steuert, ob sich das aktuell Ausgewählte RibbonDropDownItem visuell von den nicht ausgewählten Elementen unterscheidet. In einem kann jeweils nur ein Element ausgewählt RibbonGallerywerden.

Die ItemImageSize -Eigenschaft kann verwendet werden, um andere Bildgrößen als 16x16 und 32x32 anzugeben.

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 RibbonGallery 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.

Sie können eine RibbonGallery zur Laufzeit erstellen, indem Sie die CreateRibbonGallery -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 Eigenschaften dieses Steuerelements können nur vor dem Laden des Menübands in die Office-Anwendung oder vor dem Hinzufügen des Steuerelements zu einem dynamischen Menü zur Laufzeit festgelegt werden. 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 die Auflistung von Schaltflächen auf RibbonGallery ab.
ColumnCount	Ruft die Anzahl der Element-Spalten in RibbonGallery ab oder legt diese fest.
ControlSize	Ruft die Größe des RibbonGallery -Steuerelements ab oder legt diese fest.
Description	Ruft den Text ab, der in einem Menü oder einer unterteilten Schaltfläche auf diesem RibbonGallery-Steuerelement angezeigt wird, oder legt diesen fest.
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 auf der Schaltfläche angezeigte Bild ab oder legt dieses fest.
ImageName	Ruft den Namen ab oder legt den Namen fest, mit dem Sie den RibbonGallery im LoadImage-Ereignishandler identifiziert wird.
ItemImageSize	Ruft eine Size ab, die die Dimensionen der Bilder angibt, die von den Elementen im RibbonGallery angezeigt werden, oder legt sie fest.
Items	Ruft eine Auflistung der RibbonDropDownItem-Komponenten in RibbonGallery ab.
KeyTip	Ruft die Tastenkombination für dieses RibbonGallery ab oder legt sie fest.
Label	Ruft den Text ab, der in einem Menü auf RibbonGallery 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, oder legt das Bild fest, das auf dem Steuerelement angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten.
Parent	Ruft ein RibbonComponent ab, das das übergeordnete Element von RibbonComponent darstellt. (Geerbt von RibbonComponent)
Position	Ruft die Position des Katalogs oder legt sie fest, falls sich der Katalog im Microsoft Office-Menü befindet.
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)
RowCount	Ruft die Anzahl der Zeilen von RibbonDropDownItem-Komponenten ab, die von RibbonGallery angezeigt werden.
ScreenTip	Ruft Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf den RibbonGallery richtet, oder legt den Tipptext fest.
SelectedItem	Ruft das aktuell ausgewählte Element ab 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 RibbonGallery zugeordnete Bild sichtbar ist.
ShowItemImage	Ruft einen Wert ab, der angibt, ob Bilder für die Elemente in der Galerie angezeigt werden, oder legt diesen Wert fest.
ShowItemLabel	Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob für Elemente in RibbonGallery Bezeichnungen angezeigt werden.
ShowItemSelection	Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob sich das derzeit ausgewählte RibbonDropDownItem visuell vom den übrigen nicht ausgewählten Elementen unterscheidet.
ShowLabel	Ruft einen Wert ab, der angibt, ob die Bezeichnung für dieses RibbonGallery sichtbar ist, oder legt diesen Wert fest.
SuperTip	Ruft mehrzeiligen Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonGallery 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 in RibbonGallery klickt.
Click	Tritt auf, wenn ein Benutzer auf ein Element in RibbonGallery klickt.
ItemsLoading	Tritt ein, wenn RibbonGallery geöffnet wird.

Gilt für: