Leggere in inglese

Condividi tramite


Procedura dettagliata: Creare il primo componente aggiuntivo VSTO per PowerPoint

Questa procedura dettagliata illustra come creare un componente aggiuntivo VSTO per Microsoft Office PowerPoint. Le funzionalità create dall'utente in questo tipo di soluzione sono disponibili per l'applicazione stessa, indipendentemente da quali presentazioni siano aperte. Per altre informazioni, vedere Panoramica dello sviluppo di soluzioni Office (VSTO).

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti di componente aggiuntivo VSTO per PowerPoint. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

In questa procedura dettagliata sono illustrati i task seguenti:

  • Creazione di un progetto del componente aggiuntivo VSTO PowerPoint per PowerPoint.

  • Scrittura di codice che usa il modello a oggetti di PowerPoint per aggiungere una casella di testo a ogni nuova diapositiva.

  • Creazione ed esecuzione del progetto a scopo di test.

  • Pulizia del progetto, in modo che il componente aggiuntivo VSTO non venga più eseguito automaticamente nel computer di sviluppo.

    Nota

    I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzare l'IDE.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei componenti seguenti:

Creare il progetto

Per creare un nuovo progetto

  1. Avviare Visual Studio.

  2. Scegliere Nuovo dal menu Filee quindi fare clic su Progetto.

  3. Nel riquadro dei modelli, espandere Visual C# o Visual Basic, quindi espandere Office/SharePoint.

  4. Nel nodo Office/SharePoint espanso, selezionare il nodo Componenti aggiuntivi di Office .

  5. Nell'elenco dei modelli di progetto scegliere un progetto del componente aggiuntivo VSTO di PowerPoint.

  6. Nella casella Nome digitare FirstPowerPointAddIn.

  7. Fare clic su OK.

    Visual Studio crea il progetto FirstPowerPointAddIn e apre il file di codice ThisAddIn nell'editor.

Scrivere codice che aggiunge testo a ogni nuova diapositiva

Aggiungere quindi codice al file di codice ThisAddIn. Il nuovo codice usa il modello a oggetti di PowerPoint per aggiungere una casella di testo a ogni nuova diapositiva. Per impostazione predefinita, il file di codice ThisAddIn contiene il seguente codice generato:

  • Una definizione parziale della classe ThisAddIn . Questa classe fornisce un punto di ingresso per il codice e fornisce l'accesso al modello a oggetti di PowerPoint. Per altre informazioni, vedere Programmare componenti aggiuntivi VSTO. Il resto della ThisAddIn classe è definito in un file di codice nascosto che non è consigliabile modificare.

  • I gestori eventi ThisAddIn_Startup e ThisAddIn_Shutdown . Questi gestori eventi vengono chiamati quando PowerPoint carica e scarica il componente aggiuntivo VSTO. Usare questi gestori eventi per inizializzare il componente aggiuntivo VSTO al momento del caricamento e per eseguire la pulizia delle risorse usate dal componente aggiuntivo VSTO quando viene scaricato. Per altre informazioni, vedere Eventi nei progetti di Office.

Per aggiungere una casella di testo a ogni nuova diapositiva

  1. Nel file di codice ThisAddIn, aggiungere il codice seguente alla classe ThisAddIn . Questo codice definisce un gestore eventi per l'evento Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide dell'oggetto Application .

    Quando l'utente aggiunge una nuova diapositiva alla presentazione attiva, il gestore eventi aggiunge una casella di testo nella parte superiore della nuova diapositiva, quindi aggiunge il testo nella casella di testo.

    void Application_PresentationNewSlide(PowerPoint.Slide Sld)
    {
        PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
            Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
        textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
    }
    
  2. Se si usa C#, aggiungere il seguente codice al gestore eventi ThisAddIn_Startup . Questo codice è necessario per connettere il Application_PresentationNewSlide gestore eventi all'evento Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide .

    this.Application.PresentationNewSlide += 
        new PowerPoint.EApplication_PresentationNewSlideEventHandler(
        Application_PresentationNewSlide);
    

    Per modificare tutte le nuove diapositive, negli esempi di codice precedenti vengono usati i seguenti oggetti:

Testare il progetto

Quando si compila e si esegue il progetto, verificare che la casella di testo venga visualizzata nelle nuove diapositive aggiunte a una presentazione.

Per testare il progetto

  1. Premere F5 per compilare ed eseguire il progetto.

    Quando si compila il progetto, il codice viene compilato in un assembly incluso nella cartella di output di compilazione relativa al progetto. Inoltre, Visual Studio crea un set di voci del Registro di sistema che consentono a PowerPoint di individuare e caricare il componente aggiuntivo VSTO e di configurare le impostazioni di sicurezza nel computer di sviluppo per attivare l'esecuzione del componente aggiuntivo VSTO. Per altre informazioni, vedere Creare soluzioni Office.

  2. In PowerPoint, aggiungere una nuova diapositiva alla presentazione attiva.

  3. Verificare che il seguente testo venga aggiunto a una nuova casella di testo nella parte superiore della diapositiva.

    This text was added by using code.

  4. Chiudere PowerPoint.

Pulire il progetto

Al termine dello sviluppo di un progetto, rimuovere l'assembly del componente aggiuntivo VSTO, le voci del Registro di sistema e le impostazioni di sicurezza dal computer di sviluppo. In caso contrario, il componente aggiuntivo VSTO verrà eseguito ogni volta che si apre PowerPoint nel computer di sviluppo.

Per pulire il progetto

  1. In Visual Studio, nel menu Compila , fare clic su Pulisci soluzione.

Passaggi successivi

Ora che è stato creato un componente aggiuntivo VSTO di base per PowerPoint, è possibile ottenere altre informazioni sullo sviluppo di componenti aggiuntivi VSTO in questi argomenti:

  • Attività di programmazione generali che è possibile eseguire usando i componenti aggiuntivi VSTO per PowerPoint. Per altre informazioni, vedere Programmare componenti aggiuntivi VSTO.

  • Uso del modello a oggetti di PowerPoint. Per altre informazioni, vedere Soluzioni PowerPoint.

  • Personalizzazione dell'interfaccia utente di PowerPoint, ad esempio tramite l'aggiunta di una scheda personalizzata alla barra multifunzione o la creazione di un riquadro attività personalizzato. Per altre informazioni, vedere Personalizzazione dell'interfaccia utente di Office.

  • Compilazione e debug di componenti aggiuntivi VSTO per PowerPoint. Per altre informazioni, vedere Creare soluzioni Office.

  • Distribuzione di componenti aggiuntivi VSTO per PowerPoint. Per altre informazioni, vedere Distribuire una soluzione Office.