Interfaccia RibbonGallery

Articolo
08/11/2011

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 (in Microsoft.Office.Tools.Common.dll)

Sintassi

'Dichiarazione
<GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")> _
Public Interface RibbonGallery _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Il tipo RibbonGallery espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Buttons	Ottiene l'insieme dei pulsanti in RibbonGallery.
	ColumnCount	Ottiene o imposta il numero di colonne Item in RibbonGallery.
	ControlSize	Ottiene o imposta la dimensione del controllo RibbonGallery.
	Description	Ottiene o imposta il testo visualizzato nel controllo RibbonGallery in un menu o un pulsante di menu combinato.
	Enabled	Ottiene o imposta un valore che indica se l'oggetto RibbonControl è abilitato. (Ereditato da RibbonControl)
	Id	Ottiene una stringa utilizzata da Microsoft Office per identificare l'oggetto RibbonControl. (Ereditato da RibbonControl)
	Image	Ottiene o imposta l'immagine visualizzata nel pulsante.
	ImageName	Ottiene o imposta il nome utilizzabile per identificare RibbonGallery nel gestore eventi LoadImage.
	ItemImageSize	Ottiene o imposta un oggetto Size che fornisce le dimensioni delle immagini visualizzate dagli elementi in RibbonGallery.
	Items	Ottiene un insieme dei componenti RibbonDropDownItem presenti in RibbonGallery.
	KeyTip	Ottiene o imposta il tasto di scelta rapida per RibbonGallery.
	Label	Ottiene o imposta il testo visualizzato in RibbonGallery.
	Name	Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
	OfficeImageId	Ottiene o imposta l'immagine da visualizzare nel controllo se si desidera utilizzare un'icona incorporata di Microsoft Office.
	Parent	Ottiene un oggetto RibbonComponent che rappresenta l'elemento padre di RibbonComponent. (Ereditato da RibbonComponent)
	Position	Ottiene o imposta la posizione della raccolta, se questa è inclusa nel menu Microsoft Office.
	Ribbon	Ottiene l'oggetto Ribbon di primo livello contenente la gerarchia dei controlli. (Ereditato da RibbonComponent)
	RibbonUI	Infrastruttura. Ottiene l'istanza di IRibbonUI fornita dall'applicazione Microsoft Office al codice di estensibilità della barra multifunzione. (Ereditato da RibbonComponent)
	RowCount	Ottiene o imposta il numero di righe dei componenti RibbonDropDownItem visualizzati da RibbonGallery.
	ScreenTip	Ottiene o imposta il testo del suggerimento visualizzato quando il puntatore del mouse viene passato su RibbonGallery.
	SelectedItem	Ottiene o imposta l'elemento attualmente selezionato.
	SelectedItemIndex	Ottiene o imposta l'indice dell'oggetto RibbonDropDownItem attualmente selezionato.
	ShowImage	Ottiene o imposta un valore che indica se l'immagine associata a RibbonGallery è visibile o meno.
	ShowItemImage	Ottiene o imposta un valore che indica se le immagini vengono visualizzate per gli elementi della raccolta.
	ShowItemLabel	Ottiene o imposta un valore che indica se le etichette vengono visualizzate per gli elementi in RibbonGallery.
	ShowItemSelection	Ottiene o imposta un valore che indica se l'oggetto RibbonDropDownItem attualmente selezionato è visivamente distinguibile dagli altri elementi non selezionati.
	ShowLabel	Ottiene o imposta un valore che indica se l'etichetta di RibbonGallery è visibile o meno.
	Site	Ottiene o imposta l'oggetto ISite associato a IComponent. (Ereditato da IComponent)
	SuperTip	Ottiene o imposta il testo del suggerimento su più righe visualizzato quando il puntatore del mouse viene passato su RibbonGallery.
	Tag	Ottiene o imposta dati specifici dell'applicazione associati a RibbonComponent. (Ereditato da RibbonComponent)
	Visible	Ottiene o imposta un valore che indica se RibbonControl è visibile. (Ereditato da RibbonControl)

In alto

Metodi

	Nome	Descrizione
	Dispose	Esegue attività definite dall'applicazione, ad esempio libera, rilascia o reimposta risorse non gestite. (Ereditato da IDisposable)
	PerformDynamicLayout	Chiama il metodo Microsoft.Office.Core.IRibbonUI.InvalidateControl del controllo padre se l'oggetto RibbonComponent dispone di un elemento padre dinamico, ad esempio un menu dinamico, e il layout non è sospeso. (Ereditato da RibbonComponent)
	PerformLayout	Effettua la chiamata a Microsoft.Office.Core.IRibbonUI.InvalidateControl se RibbonComponent dispone di un elemento padre e il layout non è sospeso. (Ereditato da RibbonComponent)
	ResumeLayout()	Inverte l'effetto del metodo SuspendLayout. (Ereditato da RibbonComponent)
	ResumeLayout(Boolean)	Inverte l'effetto del metodo SuspendLayout. (Ereditato da RibbonComponent)
	SuspendLayout	Impedisce all'applicazione di Microsoft Office di aggiornare lo stato dei controlli nella barra multifunzione. (Ereditato da RibbonComponent)

In alto

Eventi

	Nome	Descrizione
	ButtonClick	Si verifica quando viene fatto clic su un pulsante in RibbonGallery.
	Click	Si verifica quando viene fatto clic su un elemento in RibbonGallery.
	Disposed	Rappresenta il metodo che gestisce l'evento Disposed di un componente. (Ereditato da IComponent)
	ItemsLoading	Si verifica quando l'oggetto RibbonGallery viene aperto.

In alto

Note

Analogamente all'interfaccia RibbonDropDown, RibbonGallery visualizza un menu di oggetti RibbonDropDownItem e controlli RibbonButton.

A differenza dell'interfaccia RibbonDropDown, l'interfaccia RibbonDropDownItem genera eventi RibbonGallery invece di eventi Click, quando un utente fa clic su 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.

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.

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

È possibile creare RibbonGallery in fase di esecuzione tramite il metodo CreateRibbonGallery dell'oggetto RibbonFactory.

Sono disponibili due modi per accedere all'oggetto RibbonFactory:

Mediante la proprietà Factory della classe Ribbon. Utilizzare questo approccio dal codice della classe Ribbon.
Mediante il metodo Globals.Factory.GetRibbonFactory. Utilizzare questo approccio dal codice all'esterno della classe Ribbon.

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.

Nota

Questa interfaccia è implementata da Visual Studio Tools per Office Runtime. Non deve essere implementata nel codice. Per ulteriori informazioni, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.

Utilizzo

Nella presente documentazione viene descritta la versione di questo tipo utilizzata nei progetti di Office destinati a .NET Framework 4. Nei progetti destinati a .NET Framework 3.5, questo tipo potrebbe avere membri diversi e gli esempi di codice forniti per il tipo potrebbero non funzionare. Per la documentazione relativa a questo tipo nei progetti destinati a .NET Framework 3.5, vedere la sezione di riferimento seguente nella documentazione di Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.