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.

Aggiungere il codice seguente:

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

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