Interfaccia RibbonToggleButton

Articolo
05/17/2013

Rappresenta un controllo interruttore in una barra multifunzione.

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

Sintassi

'Dichiarazione
<GuidAttribute("fc50977f-187c-4082-ab53-087e81f4ded1")> _
Public Interface RibbonToggleButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("fc50977f-187c-4082-ab53-087e81f4ded1")]
public interface RibbonToggleButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Il tipo RibbonToggleButton espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Checked	Ottiene o imposta un valore che indica se l'interruttore viene premuto o meno.
	ControlSize	Ottiene o imposta la dimensione del controllo RibbonToggleButton.
	Description	Ottiene o imposta il testo visualizzato nel controllo RibbonToggleButton incluso in un menu.
	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 controllo.
	ImageName	Ottiene o imposta il nome utilizzabile nel gestore eventi LoadImage per identificare un'immagine per il controllo.
	KeyTip	Ottiene o imposta i tasti di scelta rapida dell'interruttore.
	Label	Ottiene o imposta il testo visualizzato sull'interruttore.
	Name	Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
	OfficeImageId	Ottiene o imposta l'immagine da visualizzare in RibbonToggleButton 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 dell'oggetto RibbonToggleButton, se questo è incluso 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)
	ScreenTip	Ottiene o imposta il testo del suggerimento visualizzato quando il puntatore del mouse viene passato sull'interruttore.
	ShowImage	Ottiene o imposta un valore che indica se l'immagine associata a RibbonToggleButton è visibile o meno.
	ShowLabel	Ottiene o imposta un valore che indica se l'etichetta di RibbonToggleButton è visibile o meno.
	Site	ottiene o imposta ISite associato IComponent. (Ereditato da IComponent)
	SuperTip	Ottiene o imposta il testo su più righe del suggerimento visualizzato quando il puntatore del mouse viene passato sul controllo RibbonToggleButton.
	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 le attività definite dall'applicazione associate alla versione, il rilascio, o reimpostare le 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
	Click	Si verifica quando viene fatto clic sul controllo RibbonToggleButton.
	Disposed	rappresenta il metodo che gestisce Disposed evento di un componente. (Ereditato da IComponent)

In alto

Note

Un oggetto RibbonToggleButton può essere utilizzato per indicare se un elemento è selezionato o meno.

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

[!NOTA]

Questa interfaccia è implementata dal Runtime di Visual Studio Tools per Office. 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 e .NET Framework 4.5. 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.