Panoramica della barra multifunzione

La barra multifunzione è un modo per organizzare i comandi correlati in modo che siano più facili da trovare. I comandi vengono visualizzati come controlli sulla barra multifunzione. I controlli sono organizzati in gruppi lungo una striscia orizzontale sul bordo superiore di una finestra dell'applicazione. I gruppi correlati sono organizzati in schede.

È ora possibile accedere alla maggior parte delle funzionalità a cui è stato eseguito l'accesso tramite menu e barre degli strumenti nelle versioni precedenti di Microsoft Office System tramite la barra multifunzione. Per altre informazioni, vedere l'articolo tecnico Developer overview of the user interface for the 2007 Microsoft Office System .For more information, see the technical article Developer overview of the user interface for the 2007 Microsoft Office System.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO per le applicazioni seguenti: Excel; InfoPath 2013 e InfoPath 2010; Outlook; Powerpoint; Progetto; Visio; Parola. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Personalizzare la barra multifunzione di Microsoft Office

Per personalizzare la barra multifunzione, aggiungere uno degli elementi della barra multifunzione seguenti al progetto di Office:

• Barra multifunzione (Progettazione visiva)

• Barra multifunzione (XML)

  Ad esempio, per personalizzare la barra multifunzione di Excel, aggiungere un elemento di tale barra a un progetto di componente aggiuntivo VSTO per Excel.

Elemento della barra multifunzione (Progettazione visiva)

L'elemento barra multifunzione (Progettazione visiva) offre strumenti avanzati che semplificano la progettazione e lo sviluppo di una barra multifunzione personalizzata. Usare l'elemento della barra multifunzione (Progettazione visiva) per personalizzare la barra multifunzione nei modi seguenti:

• Aggiungere schede personalizzate o predefinite a una barra multifunzione.

• Aggiunta di gruppi personalizzati a una scheda personalizzata o incorporata

  Nota

  Una scheda o un gruppo predefinito è un gruppo già esistente sulla barra multifunzione di un app Office lication Microsoft. Ad esempio, la scheda Dati è una scheda predefinita in Excel. Il gruppo Connessione ions è un gruppo predefinito nella scheda Dati.

• Aggiunta di controlli personalizzati a un gruppo personalizzato.

• Aggiunta di controlli personalizzati alla visualizzazione backstage.

  Per altre informazioni su come personalizzare una barra multifunzione tramite l'elemento Barra multifunzione (Progettazione visiva), vedere Progettazione della barra multifunzione.

Elemento barra multifunzione (XML)

Utilizzare l'elemento barra multifunzione (XML) se si desidera personalizzare la barra multifunzione in modo che non sia supportato dall'elemento Barra multifunzione (Progettazione visiva). Utilizzare l'elemento della barra multifunzione (XML) per personalizzare la barra multifunzione nei modi seguenti:

• Aggiungere gruppi predefiniti a una scheda personalizzata o a una scheda predefinita.

• Aggiunta di controlli incorporati a un gruppo personalizzato.

• Aggiunta di codice personalizzato per eseguire l'override dei gestori eventi dei controlli incorporati.

• Personalizzazione della barra di accesso rapido.

• Condivisione di una personalizzazione della barra multifunzione tra diversi componenti aggiuntivi VSTO usando un ID completo.

  Per altre informazioni su come personalizzare la barra multifunzione tramite l'elemento Barra multifunzione (XML), vedere XML della barra multifunzione.

Esportare una barra multifunzione da Progettazione barra multifunzione a XML barra multifunzione

Se si crea una barra multifunzione utilizzando Progettazione barra multifunzione e quindi si decide di personalizzare la barra multifunzione in modo che l'elemento barra multifunzione (Progettazione visiva) non supporti, è possibile esportare la barra multifunzione in XML.

Visual Studio crea automaticamente un elemento della barra multifunzione (XML) e popola il file XML della barra multifunzione con elementi e attributi per ogni controllo sulla barra multifunzione.

Non tutte le proprietà presenti nella finestra Proprietà di Progettazione barra multifunzione vengono trasferite al file XML della barra multifunzione. Ad esempio, Visual Studio non esporta il valore della proprietà Image o Text . Questa situazione si verifica perché è necessario creare un metodo di callback nel file di codice della barra multifunzione del progetto esportato per assegnare un'immagine o impostare il testo di un controllo. In Visual Studio non vengono generati automaticamente metodi di callback come parte del processo di esportazione.

In più, i valori di proprietà predefiniti rimasti invariati non vengono visualizzati nel file XML risultante della barra multifunzione.

Per altre informazioni su come esportare la barra multifunzione in XML, vedere Procedura: Esportare una barra multifunzione dalla finestra di progettazione della barra multifunzione al codice XML della barra multifunzione.

Aggiornare il codice

Alla Esplora soluzioni viene aggiunto un nuovo file di codice della barra multifunzione. Questo file contiene la classe XML della barra multifunzione. È necessario creare metodi di callback nell'area Ribbon Callbacks di questa classe per gestire le azioni dell'utente, ad esempio la selezione di un pulsante. Spostare il codice dai gestori eventi in questi metodi di callback e modificarlo in modo che usi il modello di programmazione di estendibilità della barra multifunzione (RibbonX). Per altre informazioni, vedere Ribbon XML.

È anche necessario aggiungere codice alla classe ThisAddIn, ThisWorkbook o ThisDocument che esegue l'override del metodo CreateRibbonExtensibilityObject e restituisce la classe XML della barra multifunzione all'applicazione Office.

Per altre informazioni, vedere Ribbon XML.

Aggiungere più elementi della barra multifunzione a un progetto

È possibile aggiungere più elementi della barra multifunzione a un singolo progetto. Questa operazione è utile per eseguire una delle due attività seguenti:

• Creare barre multifunzione per i controlli di Outlook. Per altre informazioni, vedere Personalizzare una barra multifunzione per Outlook.

  Nota

  Un controllo rappresenta una finestra che viene aperta quando gli utenti eseguono determinate attività, ad esempio la creazione di un messaggio di posta elettronica.

• Selezionare la barra multifunzione da visualizzare in fase di esecuzione.

Selezionare le barre multifunzione da visualizzare in fase di esecuzione

Poiché un progetto può contenere più di una barra multifunzione, è possibile selezionare la barra multifunzione da visualizzare in fase di esecuzione.

Per selezionare una barra multifunzione da visualizzare in fase di esecuzione, eseguire l'override ThisAddindel CreateRibbonExtensibilityObject metodo nella classe , ThisWorkbooko ThisDocument del progetto e restituire la barra multifunzione da visualizzare. Nell'esempio seguente viene controllato il valore di un campo denominato myCondition e viene restituita la barra multifunzione appropriata.

Nota

La sintassi utilizzata in questo esempio restituisce una barra multifunzione creata utilizzando l'elemento della barra multifunzione (Progettazione visiva). La sintassi per la restituzione di una barra multifunzione creata tramite un elemento della barra multifunzione (XML) è leggermente diversa. Per altre informazioni sulla restituzione di un elemento barra multifunzione (XML), vedere XML della barra multifunzione.

Aggiungere il codice seguente:

C#

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
        }
        else
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
        }
    }

VB

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon1()})
    Else
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon2()})
    End If
End Function

Argomenti correlati

Posizione	Descrizione
Procedura: Introduzione alla personalizzazione della barra multifunzione	Viene illustrato come personalizzare la barra multifunzione di un oggetto Microsoft app Office lication, aggiungere un elemento barra multifunzione (Visual Designer) o barra multifunzione (XML) a un progetto di Office.
Finestra di progettazione della barra multifunzione	Viene descritto come usare Progettazione barra multifunzione per aggiungere schede, gruppi e controlli personalizzati alla barra multifunzione di un app Office lication Microsoft.
Procedura dettagliata: Creare una scheda personalizzata usando Progettazione barra multifunzione	Illustra come creare una scheda personalizzata della barra multifunzione usando la finestra di progettazione della barra multifunzione. Questa finestra di progettazione può essere usata per aggiungere e posizionare controlli sulla scheda personalizzata.
Panoramica del modello a oggetti della barra multifunzione	Fornisce una panoramica del modello a oggetti fortemente tipizzato che è possibile usare per ottenere e impostare le proprietà dei controlli della barra multifunzione in fase di esecuzione.
Procedura dettagliata: aggiornare i controlli in una barra multifunzione in fase di esecuzione	Mostra come usare il modello a oggetti della barra multifunzione per aggiornare i controlli in una barra multifunzione dopo che è stata caricata nell'applicazione di Office.
Personalizzare una barra multifunzione per Outlook	Fornisce indicazioni per personalizzare la barra multifunzione in Microsoft Office Outlook.
Personalizzare una barra multifunzione per InfoPath	Fornisce indicazioni per personalizzare la barra multifunzione in Microsoft Office InfoPath.
Accedere alla barra multifunzione in fase di esecuzione	Illustra come visualizzare, nascondere e modificare la barra multifunzione e consentire agli utenti di eseguire il codice dai controlli in un riquadro attività personalizzato, un riquadro azioni o un'area del modulo di Outlook.
Procedura: Modificare la posizione di una scheda sulla barra multifunzione	Illustra come modificare l'ordine delle schede in una barra multifunzione.
Procedura: Personalizzare una scheda predefinita	Illustra come aggiungere gruppi e controlli a una scheda incorporata.
Procedura: Aggiungere controlli alla visualizzazione Backstage	Illustra come aggiungere controlli al menu che viene aperto quando si fa clic sul file.
Procedura: Aggiungere un'utilità di avvio di una finestra di dialogo a un gruppo della barra multifunzione	Mostra l'aggiunta di un'utilità di avvio di una finestra di dialogo a qualsiasi gruppo su una barra multifunzione.
Procedura: Esportare una barra multifunzione da Progettazione barra multifunzione a XML barra multifunzione	Illustra come personalizzare la barra multifunzione in modi avanzati esportando la barra multifunzione dalla finestra di progettazione al codice XML della barra multifunzione.
Ribbon XML	Viene illustrato come personalizzare una barra multifunzione tramite XML barra multifunzione.
Procedura dettagliata: Creare una scheda personalizzata usando Progettazione barra multifunzione	Viene illustrato come creare una scheda personalizzata della barra multifunzione utilizzando l'elemento barra multifunzione (XML).