Classe RibbonGallery (System 2007)

Articolo
09/12/2008

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.