Share via


Interfaccia OfficeRibbon

Rappresenta una personalizzazione della barra multifunzione di Microsoft Office creata tramite la finestra di progettazione della barra multifunzione in un progetto Office in Visual Studio.

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

Sintassi

'Dichiarazione
<GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")> _
Public Interface OfficeRibbon _
    Inherits RibbonComponent, IComponent, IDisposable
[GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")]
public interface OfficeRibbon : RibbonComponent, 
    IComponent, IDisposable

Il tipo OfficeRibbon espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica Context Ottiene la finestra di controllo o la finestra di esplorazione in Outlook che è associata alla Barra multifunzione.
Proprietà pubblica DefaultExtension Ottiene l'estensione predefinita per l'oggetto OfficeRibbon.
Proprietà pubblica Extension Ottiene un'estensione personalizzata per l'oggetto OfficeRibbon.
Proprietà pubblica Global Ottiene o imposta un valore che determina se l'oggetto OfficeRibbon può essere utilizzato simultaneamente in più contesti.
Proprietà pubblica Name Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
Proprietà pubblica OfficeMenu Ottiene un oggetto RibbonOfficeMenu che rappresenta la personalizzazione del menu Microsoft Office.
Proprietà pubblica Parent Ottiene un oggetto RibbonComponent che rappresenta l'elemento padre di RibbonComponent. (Ereditato da RibbonComponent)
Proprietà pubblica Ribbon Ottiene l'oggetto Ribbon di primo livello contenente la gerarchia dei controlli. (Ereditato da RibbonComponent)
Proprietà pubblica RibbonId Ottiene l'ID della barra multifunzione utilizzato per creare questa istanza dell'oggetto OfficeRibbon.
Proprietà pubblica RibbonType Ottiene un elenco delimitato da virgole di ID della barra multifunzione associato a questa istanza di OfficeRibbon.
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 StartFromScratch Ottiene o imposta un valore che indica se nascondere o meno tutte le schede incorporate della barra multifunzione e la maggior parte dei comandi del menu Microsoft Office e visualizzare soltanto le personalizzazioni definite in questo elemento della barra multifunzione.
Proprietà pubblica Tabs Ottiene una raccolta di oggetti RibbonTab inclusi in RibbonOfficeMenu.
Proprietà pubblica Tag Ottiene o imposta dati specifici dell'applicazione associati a RibbonComponent. (Ereditato da RibbonComponent)

In alto

Metodi

  Nome Descrizione
Metodo pubblico _VtblGap1_2
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 Close Si verifica alla chiusura di questa istanza di OfficeRibbon.
Evento pubblico Disposed rappresenta il metodo che gestisce Disposed evento di un componente. (Ereditato da IComponent)
Evento pubblico Load Si verifica quando l'oggetto OfficeRibbon viene caricato nell'applicazione Microsoft Office.
Evento pubblico LoadImage Si verifica al caricamento di OfficeRibbon, se la proprietà ImageName è impostata per uno o più controlli.

In alto

Note

In genere, l'interfaccia OfficeRibbon non viene utilizzata direttamente.È possibile invece utilizzare la classe Ribbon generata da Visual Studio quando si aggiunge un nuovo elemento Barra multifunzione (finestra di progettazione visiva) a un progetto.È possibile portare a termine la maggior parte delle attività correlate alla barra multifunzione tramite gli eventi e le proprietà all'interno della classe Ribbon generata.

La classe Ribbon generata eredita dalla classe RibbonBase.Questa classe base reindirizza tutte le chiamate effettuate ai relativi membri a un'implementazione interna dell'interfaccia OfficeRibbon in Runtime di Visual Studio Tools per Office.Se si desidera lavorare direttamente con l'oggetto OfficeRibbon, utilizzare la proprietà Base della classe della barra multifunzione generata.

[!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