Condividi tramite


RibbonGroup Interfaccia

Definizione

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

public interface class RibbonGroup : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")>]
type RibbonGroup = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent
Attributi
Implementazioni

Commenti

Visual Studio crea un oggetto quando si trascina un RibbonGroup controllo Gruppo dalla scheda Controlli barra multifunzione di Office della casella degli strumenti nella barra multifunzione Designer.

Attività comuni

La tabella seguente elenca i membri utili per le attività comuni. Tutte queste attività possono essere eseguite in fase di progettazione. Alcune di queste attività possono essere eseguite in fase di esecuzione prima del caricamento della barra multifunzione. Per altre informazioni, vedere Panoramica del modello a oggetti della barra multifunzione.

Attività Membro
Accedere ai controlli nel gruppo, aggiungere controlli al gruppo o rimuovere i controlli dal gruppo. Usare la proprietà Items.
Aggiungere un gruppo a una scheda Barra multifunzione. Aggiungere un RibbonGroup oggetto alla Groups raccolta della scheda.
Specificare il percorso di un gruppo in una scheda predefinita, rispetto alla posizione di un gruppo predefinito. Usare la proprietà Position.

È possibile creare un RibbonGroup oggetto in fase di esecuzione usando il CreateRibbonGroup metodo dell' RibbonFactory oggetto.

Sono disponibili due modi per accedere all'oggetto RibbonFactory:

  • Usando la proprietà Factory della classe Ribbon. Usare questo approccio dal codice della classe Ribbon.

  • Usando il metodo Globals.Factory.GetRibbonFactory. Usare 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 altre informazioni, vedere Visual Studio Tools for Office Runtime Overview.

Utilizzo

In questa documentazione viene descritta la versione di questo tipo usata nei progetti Office destinati a .NET Framework 4 o versione successiva. 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: http://go.microsoft.com/fwlink/?LinkId=160658.

Proprietà

DialogLauncher

Ottiene o imposta il servizio di avvio della barra multifunzione associato al gruppo.

Id

Ottiene una stringa che identifica il gruppo corrente.

Items

Ottiene i controlli del gruppo.

KeyTip

Ottiene o imposta il tasto di scelta rapida del gruppo.

Label

Ottiene o imposta il testo visualizzato dall'etichetta del gruppo.

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)
Position

Ottiene o imposta la posizione di un gruppo in una scheda predefinita rispetto a un gruppo incorporato nella scheda.

Ribbon

Ottiene l'oggetto Ribbon di primo livello che contiene la gerarchia del controllo.

(Ereditato da RibbonComponent)
RibbonUI

Ottiene l'istanza di IRibbonUI definita dall'applicazione Microsoft Office per il codice di estendibilità della barra multifunzione.

(Ereditato da RibbonComponent)
Tag

Ottiene o imposta dati specifici dell'applicazione associati a RibbonComponent.

(Ereditato da RibbonComponent)
Visible

Ottiene o imposta un valore che indica se il gruppo è visibile o meno.

Metodi

PerformDynamicLayout()

Chiama il metodo Microsoft.Office.Core.IRibbonUI.InvalidateControl del controllo padre se RibbonComponent ha un elemento padre dinamico, ad esempio un menu dinamico, e il layout non è sospeso.

(Ereditato da RibbonComponent)
PerformLayout()

Chiama Microsoft.Office.Core.IRibbonUI.InvalidateControl se RibbonComponent ha 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)

Eventi

DialogLauncherClick

Si verifica quando l'utente fa clic sull'icona di avvio della finestra di dialogo Barra multifunzione nel gruppo.

Si applica a