Condividi tramite


Interfaccia RibbonOfficeMenu

Fornisce accesso ai controlli aggiunti al menu Microsoft Office.

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

Sintassi

'Dichiarazione
<GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")> _
Public Interface RibbonOfficeMenu _
    Inherits RibbonComponent, IComponent, IDisposable
[GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : RibbonComponent, 
    IComponent, IDisposable

Il tipo RibbonOfficeMenu espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica Items Ottiene i controlli della barra multifunzione aggiunti al menu Microsoft Office.
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 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)

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 Disposed rappresenta il metodo che gestisce Disposed evento di un componente. (Ereditato da IComponent)

In alto

Note

Quando si aggiunge un elemento Barra multifunzione (finestra di progettazione visiva) a un progetto, in Visual Studio viene assegnato automaticamente un nuovo oggetto RibbonOfficeMenu alla proprietà OfficeMenu dell'interfaccia OfficeRibbon generata.Utilizzare l'oggetto per aggiungere nuovi controlli al menu Microsoft Office in fase di esecuzione oppure per accedere ai controlli aggiunti a tale menu.

È possibile aggiungere controlli in fase di esecuzione, unicamente prima del caricamento della barra multifunzione.Creare un'istanza del controllo e aggiungere quindi il nuovo controllo alla raccolta Items.Per ulteriori informazioni, vedere Cenni preliminari sul modello a oggetti della barra multifunzione.

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

Esempi

Nell'esempio seguente vengono scorsi i controlli personalizzati del menu Office della barra multifunzione e visualizzati i rispettivi nomi.Per eseguire questo esempio di codice, effettuare innanzitutto le seguenti operazioni:

  1. Aggiungere un elemento Barra multifunzione (finestra di progettazione visiva) a un progetto Office.

  2. Aggiungere un pulsante al pulsante Microsoft Office.

  3. Impostare la proprietà (Name) del pulsante su myOfficeMenuButton.

  4. Impostare la proprietà PositionType su AfterOfficeID nella proprietà Position.

  5. Impostare la proprietà OfficeID su FilePrintMenu nella proprietà Position.

Private Sub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    For Each control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    Next
End Sub
private void ListOfficeRibbonCustomControls()
{
    System.Windows.Forms.MessageBox.Show(
        "Listing all Office Menu custom controls...");
    foreach (RibbonComponent control in Globals.Ribbons.Ribbon1.OfficeMenu.Items)
    {
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name);
    }
}

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Office.Tools.Ribbon

Altre risorse

Procedura: aggiungere controlli alla visualizzazione Backstage

Cenni preliminari sul modello a oggetti della barra multifunzione