Condividi tramite

Procedura: esportare una barra multifunzione dalla finestra di progettazione in un elemento XML della barra

  • Articolo

L'elemento Barra multifunzione (finestra di progettazione visiva) non supporta tutti i possibili tipi di personalizzazione della barra multifunzione. Per personalizzare la barra multifunzione in modalità avanzate è possibile esportare la barra multifunzione dalla finestra di progettazione nell'XML della barra multifunzione.

Nota

Non tutti i valori delle proprietà sono presenti nel file XML della barra multifunzione. Per ulteriori informazioni, vedere Cenni preliminari sulla barra multifunzione.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Excel 2007, Excel 2010, InfoPath 2010, Outlook 2007, Outlook 2010, PowerPoint 2007, PowerPoint 2010, Project 2010, Visio 2010, Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Per esportare una barra multifunzione dalla finestra di progettazione in un elemento XML della 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 sulla finestra di progettazione della barra multifunzione, quindi scegliere Esporta barra multifunzione in XML.

    In Visual Studio viene aggiunto un file XML e un file di codice XML della barra multifunzione al progetto.

  3. Nella classe del codice della barra multifunzione, trovare 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 che si sta sviluppando.

    Questo codice consente all'applicazione di Microsoft Office di individuare e caricare la barra multifunzione personalizzata. Per ulteriori informazioni, vedere Elemento XML della barra multifunzione.

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

    Dopo avere rimosso il commento dal codice, il risultato sarà simile all'esempio seguente. In questo esempio la classe Ribbon è denominata MyRibbon.

    Protected Overrides Function CreateRibbonExtensibilityObject() As  _
Microsoft.Office.Core.IRibbonExtensibility
    Return New MyRibbon()
End Function

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
{
    return new MyRibbon();
}

  6. Passare al file di codice XML della barra multifunzione e cercare l'area Ribbon Callbacks.

    In questa area si scrivono i metodi di callback per gestire le azioni dell'utente, ad esempio la selezione di un pulsante tramite il mouse.

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

  8. Spostare tutto il codice dai gestori eventi in questi metodi di callback e modificarlo in modo che utilizzi il modello di programmazione di estensibilità della barra multifunzione (RibbonX).

    Per informazioni sulla scrittura dei metodi di callback e l'utilizzo del modello di programmazione RibbonX, vedere Elemento XML della barra multifunzione.

Vedere anche

Attività

Procedura dettagliata: creazione di una scheda personalizzata utilizzando la finestra di progettazione della barra multifunzione

Procedura dettagliata: creazione di una scheda personalizzata utilizzando l'elemento XML della barra multifunzione

Concetti

Finestra di progettazione della barra multifunzione

Elemento XML della barra multifunzione

Altre risorse

Cenni preliminari sulla barra multifunzione

Cronologia delle modifiche

Data

Cronologia

Motivo

Settembre 2010

Modificato il nome della classe Ribbon indicata nel testo in modo che corrisponda all'esempio di codice.

Correzione di bug nel contenuto.