RibbonGallery-Klasse (2007 System)

Článek
08/23/2008

Aktualisiert: November 2007

Stellt ein Steuerelement dar, in dem ein Menü von RibbonDropDownItem-Objekten und RibbonButton-Steuerelementen angezeigt wird.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Syntax

'Declaration
<ToolboxBitmapAttribute(GetType(RibbonGallery), "RibbonGallery.bmp")> _
Public NotInheritable Class RibbonGallery _
    Inherits RibbonControl
'Usage
Dim instance As RibbonGallery

[ToolboxBitmapAttribute(typeof(RibbonGallery), "RibbonGallery.bmp")]
public sealed class RibbonGallery : RibbonControl

Hinweise

Ebenso wie die RibbonDropDown-Klasse zeigt RibbonGallery ein Menü von RibbonDropDownItem-Objekten und RibbonButton-Steuerelementen an.

Im Gegensatz zur RibbonDropDown-Klasse werden von der RibbonGallery-Klasse Click-Ereignisse und keine SelectionChanged-Ereignisse ausgelöst, wenn ein Benutzer auf RibbonDropDownItem klickt. 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 ursprüngliche Auswahl für dasselbe Szenario in RibbonDropDown getroffen wurde, und zwar abhängig von der Auswahl vor dem ersten Klick.)

Mit der ShowItemSelection-Eigenschaft wird gesteuert, ob sich das derzeit ausgewählte RibbonDropDownItem visuell von den nicht ausgewählten Elementen unterscheidet. In RibbonGallery kann jeweils nur ein Element ausgewählt werden.

Mit der ItemImageSize-Eigenschaft können andere Bildgrößen als 16x16 und 32x32 angegeben werden.

RibbonGallery können während der Entwurfs- oder Laufzeit RibbonDropDownItem-Objekte hinzugefügt werden.

So fügen Sie während der Entwurfszeit RibbonDropDownItem-Objekte hinzu

Klicken Sie im Fenster Eigenschaften auf die Eigenschaft Items-Eigenschaft.
Klicken Sie auf die Ellipse (…).
Im Dropdownauflistungs-Editor werden neue Elemente hinzugefügt, sortiert und bearbeitet.

In den folgenden Schritten wird das Hinzufügen von RibbonDropDownItem während der Laufzeit erläutert.

So fügen Sie während der Laufzeit ein RibbonDropDownItem-Objekt hinzu

Erstellen Sie mithilfe von RibbonDropDownItem ein neues RibbonDropDownItem.
Fügen Sie das erstellte RibbonDropDownItem der Items-Auflistung dieses RibbonGallery-Objekts hinzu.

Sie können RibbonGallery während der Entwurfszeit RibbonButton-Steuerelemente hinzufügen.

So fügen Sie während der Entwurfszeit RibbonButton-Steuerelemente hinzu

Klicken Sie im Fenster Eigenschaften auf die Buttons-Eigenschaft .
Klicken Sie auf die Ellipse (…).
Im Schaltflächenauflistungs-Editor werden neue Schaltflächensteuerelemente hinzugefügt, sortiert und bearbeitet.

Einige Eigenschaften dieses Steuerelements können nur festgelegt werden, bevor die Multifunktionsleiste in die Office-Anwendung geladen wird oder bevor das Steuerelement während der Laufzeit einem dynamischen Menü hinzugefügt wird. Informationen zum Festlegen dieser Eigenschaften finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

Vererbungshierarchie

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonGallery

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.