Interfaccia RibbonLabel

Articolo
08/11/2011

Rappresenta un'etichetta in oggetto RibbonGroup o RibbonBox.

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

Sintassi

'Dichiarazione
<GuidAttribute("7182361b-5a62-424e-9ab4-6d9a78432fb7")> _
Public Interface RibbonLabel _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("7182361b-5a62-424e-9ab4-6d9a78432fb7")]
public interface RibbonLabel : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Il tipo RibbonLabel espone i seguenti membri.

Proprietà

	Nome	Descrizione
	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)
	Label	Ottiene o imposta il testo visualizzato dall'etichetta.
	Name	Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
	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	La proprietà non ha alcun effetto.
	ShowLabel	Ottiene o imposta un valore che indica se il testo visualizzato dall'etichetta è visibile o meno.
	Site	Ottiene o imposta l'oggetto ISite associato a IComponent. (Ereditato da IComponent)
	SuperTip	La proprietà non ha alcun effetto.
	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
	Disposed	Rappresenta il metodo che gestisce l'evento Disposed di un componente. (Ereditato da IComponent)

In alto

Note

Visual Studio crea automaticamente un oggetto RibbonLabel quando si trascina un controllo Label dalla scheda Controlli barra multifunzione di Office della Casella degli strumenti alla finestra di progettazione della barra multifunzione.

Per aggiungere un'etichetta a un gruppo in fase di esecuzione, creare un nuovo oggetto RibbonLabel e aggiungerlo quindi all'insieme Items di RibbonGroup oppure all'insieme Items di RibbonBox. Questa operazione può essere seguita unicamente prima del caricamento della barra multifunzione. Per ulteriori informazioni, vedere Cenni preliminari sul modello a oggetti della barra multifunzione.

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