Condividi tramite


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

L'elemento della barra multifunzione (Progettazione visiva) non supporta tutti i possibili tipi di personalizzazione della barra multifunzione. Per personalizzare la barra multifunzione in modi avanzati, è possibile esportare la barra multifunzione dalla finestra di progettazione in XML della barra multifunzione e modificare direttamente il codice XML.

Nota

Non tutti i valori delle proprietà vengono visualizzati nel file XML della barra multifunzione. Per altre informazioni, vedere Panoramica della barra multifunzione.

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.

Per esportare una barra multifunzione da Progettazione barra multifunzione a XML barra multifunzione

  1. Fare clic con il pulsante destro del mouse sul file di codice della barra multifunzione in Esplora soluzioni, quindi scegliere Visualizza finestra di progettazione.

  2. Fare clic con il pulsante destro del mouse su Progettazione barra multifunzione, quindi scegliere Esporta barra multifunzione in XML.

    Visual Studio aggiunge un file XML della barra multifunzione e un file di codice XML della barra multifunzione al progetto.

  3. Nella classe di codice della barra multifunzione individuare i commenti che iniziano con TODO:.

  4. Copiare il blocco di codice in questi commenti nella classe ThisAddin, ThisWorkbook o ThisDocument , a seconda del tipo di soluzione in fase di sviluppo.

    Questo codice consente a Microsoft app Office lication di individuare e caricare la barra multifunzione personalizzata. Per altre informazioni, vedere Ribbon XML.

  5. Nella classe ThisAddin, ThisWorkbook o ThisDocument rimuovere il commento dal blocco di codice.

    Dopo aver rimosso il commento, il codice dovrebbe essere simile all'esempio seguente. In questo esempio la classe Ribbon è denominata MyRibbon.

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
    {
        return new MyRibbon();
    }
    
  6. Passare al file di codice XML della barra multifunzione e trovare l'area Ribbon Callbacks .

    Qui si scrivono metodi di callback per gestire le azioni utente, ad esempio facendo clic su un pulsante.

  7. Creare un metodo di callback per ogni gestore eventi scritto nel codice della finestra di progettazione della barra multifunzione.

  8. Spostare tutto il codice del gestore eventi dai gestori eventi ai metodi di callback e modificare il codice in modo che funzioni con il modello di programmazione Ribbon Extensibility (RibbonX).

    Per informazioni sulla scrittura di metodi di callback e sull'uso del modello di programmazione RibbonX, vedere XML della barra multifunzione.