RibbonOfficeMenu Interfaccia

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Ribbon

Assembly:: Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce accesso ai controlli aggiunti al menu Microsoft Office.

public interface class RibbonOfficeMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")>]
type RibbonOfficeMenu = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonOfficeMenu
Implements IComponent, IDisposable, RibbonComponent

Attributi: GuidAttribute

Implementazioni: RibbonComponent IComponent IDisposable

Esempio

Nell'esempio seguente viene eseguita l'iterazione dei controlli personalizzati nel menu di Office della barra multifunzione e ne viene visualizzato il nome. Per eseguire questo esempio di codice, è necessario eseguire prima i passaggi seguenti:

Aggiungere un elemento barra multifunzione (finestra di progettazione visiva) a un progetto di Office.
Aggiungere un pulsante al pulsante Microsoft Office.
Impostare la proprietà (Name) del pulsante su myOfficeMenuButton .
Impostare la proprietà PositionType su AfterOfficeId nella proprietà position .
Impostare la proprietà OfficeId su FilePrintMenu nella proprietà position .

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);
    }
}

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

Commenti

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

È possibile aggiungere controlli in fase di esecuzione, ma solo prima del caricamento della barra multifunzione. Creare un'istanza del controllo e quindi aggiungere il nuovo controllo alla Items raccolta. Per altre informazioni, vedere Panoramica del modello a oggetti della barra multifunzione.

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à

Items	Ottiene i controlli della barra multifunzione che sono stati aggiunti al menu Microsoft Office.
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 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)

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)

Si applica a

Condividi tramite