Classe RibbonGallery (System 2007)
Aggiornamento: novembre 2007
Rappresenta un controllo che visualizza un menu di oggetti RibbonDropDownItem e controlli RibbonButton.
Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Sintassi
<ToolboxBitmapAttribute(GetType(RibbonGallery), "RibbonGallery.bmp")> _
Public NotInheritable Class RibbonGallery _
Inherits RibbonControl
Dim instance As RibbonGallery
[ToolboxBitmapAttribute(typeof(RibbonGallery), "RibbonGallery.bmp")]
public sealed class RibbonGallery : RibbonControl
Note
Analogamente alla classe RibbonDropDown, RibbonGallery visualizza un menu di oggetti RibbonDropDownItem e controlli RibbonButton.
A differenza della classe RibbonDropDown, quando viene fatto clic su RibbonDropDownItem la classe RibbonGallery genera eventi Click, piuttosto che eventi SelectionChanged. Vale a dire che facendo clic due volte sullo stesso oggetto RibbonDropDownItem, ad esempio, l'evento Click viene generato due volte. Effettuando la selezione iniziale per lo stesso scenario su RibbonDropDown, l'evento SelectionChanged verrebbe generato al massimo una volta, a seconda dello stato della selezione prima del primo clic.
La proprietà ShowItemSelection controlla che l'oggetto RibbonDropDownItem attualmente selezionato sia visivamente distinguibile dagli elementi non selezionati. In RibbonGallery è possibile selezionare un solo elemento alla volta.
La proprietà ItemImageSize consente di specificare dimensioni delle immagini diverse da 16 per 16 e 32 per 32.
È possibile aggiungere oggetti RibbonDropDownItem a RibbonGallery in fase di progettazione o in fase di esecuzione.
Per aggiungere oggetti RibbonDropDownItem in fase di progettazione
Nella finestra Proprietà fare clic sulla proprietà Elementi.
Fare clic sui puntini di sospensione (...).
Nell'editor dell'insieme DropDown, aggiungere nuovi elementi, ordinarli e modificarli.
Nei passaggi riportati di seguito viene illustrato come aggiungere oggetti RibbonDropDownItem in fase di esecuzione.
Per aggiungere oggetti RibbonDropDownItem in fase di esecuzione
Creare un nuovo oggetto RibbonDropDownItem mediante RibbonDropDownItem.
Aggiungere l'oggetto RibbonDropDownItem creato all'insieme Items dell'oggetto RibbonGallery.
È possibile aggiungere controlli RibbonButton a RibbonGallery in fase di progettazione.
Per aggiungere controlli RibbonButton in fase di progettazione
Nella finestra Proprietà fare clic sulla proprietà Pulsanti.
Fare clic sui puntini di sospensione (...).
Nell'editor dell'insieme Button, aggiungere nuovi controlli pulsante, ordinarli e modificarli.
Alcune proprietà di questo controllo possono essere impostate soltanto prima che la barra multifunzione venga caricata nell'applicazione di Office o prima che il controllo venga aggiunto a un menu dinamico in fase di esecuzione. Per ulteriori informazioni sull'impostazione di tali proprietà, vedere Cenni preliminari sul modello a oggetti della barra multifunzione.
Gerarchia di ereditarietà
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
Microsoft.Office.Tools.Ribbon.RibbonComponent
Microsoft.Office.Tools.Ribbon.RibbonControl
Microsoft.Office.Tools.Ribbon.RibbonGallery
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Vedere anche
Riferimenti
Spazio dei nomi Microsoft.Office.Tools.Ribbon
Altre risorse
Cenni preliminari sulla barra multifunzione
Finestra di progettazione della barra multifunzione
Cenni preliminari sul modello a oggetti della barra multifunzione