Interfaccia RibbonDropDown

Articolo
08/11/2011

Rappresenta un elenco di elementi selezionabili e un elenco di pulsanti della barra multifunzione sui quali è possibile fare clic.

Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Sintassi

'Dichiarazione
<GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")> _
Public Interface RibbonDropDown _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Il tipo RibbonDropDown espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Buttons	Ottiene un insieme di oggetti RibbonButton appartenenti all'oggetto RibbonDropDown.
	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 un'immagine visualizzata in RibbonDropDown.
	ImageName	Ottiene o imposta il nome utilizzabile nel gestore eventi LoadImage per identificare un'immagine per il controllo.
	Items	Ottiene un insieme degli elementi presenti in RibbonDropDown.
	KeyTip	Ottiene o imposta il tasto di scelta rapida per RibbonDropDown.
	Label	Ottiene o imposta il testo visualizzato in RibbonDropDown.
	Name	Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
	OfficeImageId	Ottiene o imposta l'immagine da visualizzare in RibbonDropDown 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)
	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)
	ScreenTip	Ottiene o imposta il testo del suggerimento visualizzato quando il puntatore del mouse viene passato su RibbonDropDown.
	SelectedItem	Ottiene o imposta l'oggetto RibbonDropDownItem 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 RibbonDropDown è visibile o meno.
	ShowItemImage	Ottiene o imposta un valore che indica se le immagini vengono visualizzate per gli elementi del menu a discesa.
	ShowItemLabel	Ottiene o imposta un valore che indica se le etichette vengono visualizzate per gli elementi del menu a discesa.
	ShowLabel	Ottiene o imposta un valore che indica se l'etichetta di RibbonDropDown è visibile o meno.
	Site	Ottiene o imposta l'oggetto ISite associato a IComponent. (Ereditato da IComponent)
	SizeString	Ottiene o imposta una stringa che determina le dimensioni di RibbonDropDown.
	SuperTip	Ottiene o imposta il testo del suggerimento su più righe visualizzato quando il puntatore del mouse viene passato su RibbonDropDown.
	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 RibbonDropDown.
	Disposed	Rappresenta il metodo che gestisce l'evento Disposed di un componente. (Ereditato da IComponent)
	ItemsLoading	Si verifica quando i controlli vengono caricati in RibbonDropDown.
	SelectionChanged	Si verifica quando viene selezionato un nuovo elemento in un controllo a discesa di una barra multifunzione.

In alto

Note

Un oggetto RibbonDropDown è in grado di contenere oggetti RibbonDropDownItem e controlli RibbonButton.

È possibile creare RibbonDropDown in fase di esecuzione tramite il metodo CreateRibbonDropDown 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.

Non è possibile aggiungere pulsanti alla raccolta Buttons in fase di esecuzione dopo il caricamento della barra multifunzione nell'applicazione Office.

Nelle procedure riportate di seguito viene illustrato come aggiungere oggetti RibbonDropDownItem e controlli RibbonButton a RibbonDropDown.

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

Alcuni membri di questo tipo possono essere impostati unicamente prima del caricamento della barra multifunzione nell'applicazione di Office. 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.