Condividi tramite


Interfaccia RibbonGroup

Rappresenta un gruppo di controlli in una scheda della barra multifunzione.

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

Sintassi

'Dichiarazione
<GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable
[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

Il tipo RibbonGroup espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica DialogLauncher Ottiene o imposta il pulsante di visualizzazione della finestra di dialogo della barra multifunzione associato al gruppo.
Proprietà pubblica Id Ottiene una stringa che identifica il gruppo corrente.
Proprietà pubblica Items Ottiene i controlli del gruppo.
Proprietà pubblica KeyTip Ottiene o imposta il tasto di scelta rapida per il gruppo.
Proprietà pubblica Label Ottiene o imposta il testo visualizzato dall'etichetta del gruppo.
Proprietà pubblica Name Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
Proprietà pubblica Parent Ottiene un oggetto RibbonComponent che rappresenta l'elemento padre di RibbonComponent. (Ereditato da RibbonComponent)
Proprietà pubblica Position Ottiene o imposta la posizione di un gruppo in una scheda incorporata rispetto a un gruppo incorporato nella scheda.
Proprietà pubblica Ribbon Ottiene l'oggetto Ribbon di primo livello contenente la gerarchia dei controlli. (Ereditato da RibbonComponent)
Proprietà pubblica RibbonUI Infrastruttura. Ottiene l'istanza di IRibbonUI fornita dall'applicazione Microsoft Office al codice di estensibilità della barra multifunzione. (Ereditato da RibbonComponent)
Proprietà pubblica Site ottiene o imposta ISite associato IComponent. (Ereditato da IComponent)
Proprietà pubblica Tag Ottiene o imposta dati specifici dell'applicazione associati a RibbonComponent. (Ereditato da RibbonComponent)
Proprietà pubblica Visible Ottiene o imposta un valore che indica se il gruppo è visibile.

In alto

Metodi

  Nome Descrizione
Metodo pubblico Dispose Esegue le attività definite dall'applicazione associate alla versione, il rilascio, o reimpostare le risorse non gestite. (Ereditato da IDisposable)
Metodo pubblico 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)
Metodo pubblico 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)
Metodo pubblico ResumeLayout() Inverte l'effetto del metodo SuspendLayout. (Ereditato da RibbonComponent)
Metodo pubblico ResumeLayout(Boolean) Inverte l'effetto del metodo SuspendLayout. (Ereditato da RibbonComponent)
Metodo pubblico SuspendLayout Impedisce all'applicazione di Microsoft Office di aggiornare lo stato dei controlli nella barra multifunzione. (Ereditato da RibbonComponent)

In alto

Eventi

  Nome Descrizione
Evento pubblico DialogLauncherClick Si verifica quando viene fatto clic sull'icona del pulsante di visualizzazione della finestra di dialogo della barra multifunzione nel gruppo.
Evento pubblico Disposed rappresenta il metodo che gestisce Disposed evento di un componente. (Ereditato da IComponent)

In alto

Note

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

Attività comuni

Nella tabella riportata di seguito vengono elencati membri utili per le attività comuni,tutte eseguibili in fase di progettazione.Alcune di queste attività possono essere eseguite in fase di esecuzione prima del caricamento della barra multifunzione.Per ulteriori informazioni, vedere Cenni preliminari sul modello a oggetti della barra multifunzione.

Task

Membro

Aggiungere, rimuovere o accedere ai controlli nel gruppo.

Utilizzare la proprietà Items.

Aggiungere un gruppo a una scheda della barra multifunzione.

Aggiungere un oggetto RibbonGroup alla raccolta Groups della scheda.

Specificare la posizione di un gruppo in una scheda incorporata rispetto a quella di un gruppo incorporato.

Utilizzare la proprietà Position.

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

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Office.Tools.Ribbon

Altre risorse

Cenni preliminari sulla barra multifunzione

Finestra di progettazione della barra multifunzione

Cenni preliminari sul modello a oggetti della barra multifunzione

Procedura: iniziare a personalizzare la barra multifunzione

Procedura: personalizzare una scheda incorporata