RibbonMenu Interfaccia

Riferimento

Definizione

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

Assembly:: Microsoft.Office.Tools.Common.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.

Rappresenta un menu in una scheda della barra multifunzione o nel menu Microsoft Office.

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:

Aggiungere un elemento barra multifunzione (finestra di progettazione visiva) a un progetto di Office.
Aggiungere un gruppo alla scheda personalizzata.
Aggiungere un menu al gruppo.
Impostare la proprietà (Name) del menu su CustomerMenu.
Impostare la proprietà Label del menu su Customers.
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.

Attività	Membro
Visualizzare un'immagine nel menu.	Usare la Image proprietà o ImageName . È anche possibile riutilizzare le immagini visualizzate nei controlli della barra multifunzione predefiniti. A tale scopo, impostare OfficeImageId sull'ID di un'immagine di Microsoft Office predefinita da visualizzare come icona per il menu.
Modificare le dimensioni del menu.	Impostare la ControlSize proprietà sul valore desiderato. Ad esempio, per un menu di grandi dimensioni, impostarlo su `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`.
Modificare le dimensioni delle voci nel menu.	Impostare la ItemSize proprietà sul valore desiderato. Ad esempio, per visualizzare elementi di dimensioni maggiori, impostarlo su `Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge`.
Abilitare le modifiche al menu in fase di esecuzione, ad esempio per abilitare l'aggiunta dei controlli al menu in fase di esecuzione.	Impostare la proprietà Dynamic su `true`.
Accedere ai controlli nel menu, aggiungere controlli al menu o rimuovere i controlli dal menu.	Usare la proprietà Items.
Aggiungere un menu al menu di Microsoft Office, a un gruppo o a un altro controllo che può contenere menu.	Aggiungere un RibbonMenu oggetto alla `Items` proprietà del menu, del gruppo o del controllo di Microsoft Office.

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à

ControlSize	Ottiene o imposta le dimensioni del menu.
Description	Ottiene o imposta il testo visualizzato nel menu corrente.
Dynamic	Ottiene o imposta un valore che indica se il menu può essere modificato in fase di esecuzione.
Enabled	Ottiene o imposta un valore che indica se RibbonControl è abilitato. (Ereditato da RibbonControl)
Id	Ottiene una stringa usata da Microsoft Office per identificare questo oggetto RibbonControl. (Ereditato da RibbonControl)
Image	Ottiene o imposta l'immagine visualizzata nel menu.
ImageName	Ottiene o imposta il nome che ouò essere usato nel gestore eventi LoadImage per identificare un'immagine per il menu.
Items	Ottiene la raccolta di controlli presenti nel menu.
ItemSize	Ottiene o imposta le dimensioni dei controlli nel menu.
KeyTip	Ottiene o imposta il tasto di scelta da tastiera del menu.
Label	Ottiene o imposta il testo visualizzato dal menu.
Name	Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
OfficeImageId	Ottiene o imposta l'immagine da visualizzare nel menu, se si vuole usare un'icona predefinita di Microsoft Office.
Parent	Ottiene un oggetto RibbonComponent che rappresenta l'elemento padre di RibbonComponent. (Ereditato da RibbonComponent)
Position	Ottiene o imposta la posizione del menu, se questo è incluso nel menu Microsoft Office.
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)
ScreenTip	Ottiene o imposta il testo del suggerimento visualizzato quando il puntatore del mouse viene passato sul menu.
ShowImage	Ottiene o imposta un valore che indica se l'immagine associata al menu è visibile o meno.
ShowLabel	Ottiene o imposta un valore che indica se l'etichetta per il menu è visibile o meno.
SuperTip	Ottiene o imposta il testo del suggerimento su più righe visualizzato quando il puntatore del mouse viene passato sul menu.
Tag	Ottiene o imposta dati specifici dell'applicazione associati a RibbonComponent. (Ereditato da RibbonComponent)
Title	Ottiene o imposta il titolo visualizzato quando l'utente espande un menu che viene aggiunto al menu Microsoft Office.
Visible	Ottiene o imposta un valore che indica se RibbonControl è visibile. (Ereditato da RibbonControl)

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

ItemsLoading

Si verifica quando i controlli o i menu annidati vengono caricati nel menu corrente in fase di esecuzione.

Si applica a

Condividi tramite