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.
Per completare questa procedura dettagliata, è necessario disporre dei componenti seguenti:
Una versione di Visual Studio che include Microsoft Office Developer Tools. Per altre informazioni, vedere Configurare un computer per sviluppare soluzioni Office.
PowerPoint
Avviare Visual Studio.
Scegliere Nuovo dal menu Filee quindi fare clic su Progetto.
Nel riquadro dei modelli, espandere Visual C# o Visual Basic, quindi espandere Office/SharePoint.
Nel nodo Office/SharePoint espanso, selezionare il nodo Componenti aggiuntivi di Office .
Nell'elenco dei modelli di progetto scegliere un progetto del componente aggiuntivo VSTO di PowerPoint.
Nella casella Nome digitare FirstPowerPointAddIn.
Fare clic su OK.
Visual Studio crea il progetto FirstPowerPointAddIn e apre il file di codice ThisAddIn nell'editor.
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 dellaThisAddIn
classe è definito in un file di codice nascosto che non è consigliabile modificare.I gestori eventi
ThisAddIn_Startup
eThisAddIn_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.
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.
Se si usa C#, aggiungere il seguente codice al gestore eventi
ThisAddIn_Startup
. Questo codice è necessario per connettere ilApplication_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:
Il campo
Application
della classeThisAddIn
. IlApplication
campo restituisce un oggetto Application , che rappresenta l'istanza corrente di PowerPoint.Parametro
Sld
del gestore eventi per l'evento Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide . IlSld
parametro è un oggetto Slide , che rappresenta la nuova diapositiva. Per altre informazioni, vedere Soluzioni PowerPoint.
Quando si compila e si esegue il progetto, verificare che la casella di testo venga visualizzata nelle nuove diapositive aggiunte a una presentazione.
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.
In PowerPoint, aggiungere una nuova diapositiva alla presentazione attiva.
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.
Chiudere PowerPoint.
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.
- In Visual Studio, nel menu Compila , fare clic su Pulisci soluzione.
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.