RibbonMenu Interfaccia

Definizione

public interface class RibbonMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")]
public interface RibbonMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")>]
type RibbonMenu = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonMenu
Implements IComponent, IDisposable, RibbonControl

Attributi

GuidAttribute

Implementazioni

RibbonComponent RibbonControl IComponent IDisposable

Esempio

Nell'esempio seguente viene illustrato come aggiungere e popolare un sottomenu a un menu esistente in fase di esecuzione.

Per un esempio più completo che aggiorna i controlli in fase di esecuzione e comporta l'acquisizione di dati dal database di esempio AdventureWorks tramite query Language-Integrated (LINQ), vedere Procedura dettagliata: Aggiornamento dei controlli su una barra multifunzione in fase di esecuzione.

Per eseguire questo esempio di codice, è necessario eseguire prima i passaggi seguenti:

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

2. Aggiungere un gruppo alla scheda personalizzata.

3. Aggiungere un menu al gruppo.

4. Impostare la proprietà (Name) del menu su CustomerMenu.

5. Impostare la proprietà Label del menu su Customers.

6. Impostare la proprietà Dynamic del menu su true.

   In tal modo, è possibile aggiungere e rimuovere i controlli nel menu in fase di esecuzione dopo che la barra multifunzione è stata caricata nell'applicazione Office.

private void PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu
    // First sub-menu
    RibbonMenu subMenu1 = this.Factory.CreateRibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = this.Factory.CreateRibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}

Private Sub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu
    ' First sub-menu
    Dim subMenu1 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menu
    Dim subMenu2 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

End Sub

Commenti

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

È possibile creare un RibbonMenu oggetto in fase di esecuzione usando il CreateRibbonMenu 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.

Attività comuni

Nella tabella seguente sono elencati 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 solo prima che la barra multifunzione venga caricata nell'applicazione di Office o prima che il controllo venga aggiunto a un menu dinamico in fase di esecuzione. Per altre informazioni, vedere Panoramica del modello a oggetti della barra multifunzione.

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à

Metodi

Eventi

Si applica a