Procedura dettagliata: creazione di un componente aggiuntivo a livello di applicazione per PowerPoint

Articolo
08/11/2011

In questa procedura dettagliata viene illustrato come creare un componente aggiuntivo a livello di applicazione per Microsoft Office PowerPoint. Le funzionalità create in questo tipo di soluzione sono disponibili per l'applicazione indipendentemente dalle presentazioni aperte. Per ulteriori informazioni, vedere la classe Cenni preliminari sullo sviluppo di soluzioni Office.

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

In questa procedura dettagliata vengono illustrate le seguenti attività:

Creazione di un progetto relativo al componente aggiuntivo per PowerPoint.
Scrittura del codice che utilizza il modello a oggetti di PowerPoint per aggiungere una casella di testo a ciascuna nuova diapositiva.
Compilazione ed esecuzione del progetto a scopo di verifica.
Pulitura del progetto in modo che il componente aggiuntivo non venga più eseguito automaticamente nel computer di sviluppo.

Nota

Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Collegamento a video Per una dimostrazione video correlata, vedere la procedura di creazione di un componente aggiuntivo per Microsoft PowerPoint.

Prerequisiti

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

Una versione di Visual Studio 2010 che include gli strumenti per sviluppatori di Microsoft Office. Per ulteriori informazioni, vedere [Configurazione di un computer per sviluppare soluzioni Office](bb398242\(v=vs.100\).md).

PowerPoint 2007 o PowerPoint 2010.

Creazione del progetto

Per creare un nuovo progetto

Avviare Visual Studio.
Scegliere Nuovo dal menu File, quindi fare clic su Progetto.
Nel riquadro dei modelli espandere Visual C# o Visual Basic, quindi espandere Office.
In corrispondenza del nodo Office espanso selezionare 2007 se è installato PowerPoint 2007 o selezionare il nodo 2010 se è installato PowerPoint 2010.
Nell'elenco di modelli di progetto selezionare Componente aggiuntivo per PowerPoint 2007 o Componente aggiuntivo per PowerPoint 2010.
Nella casella Nome digitare FirstPowerPointAddIn.
Scegliere OK.

Visual Studio consente di creare il progetto FirstPowerPointAddIn e di aprire il file di codice ThisAddIn nell'editor.

Scrittura del codice che aggiunge il testo a ogni nuova dispositiva

Successivamente, aggiungere codice al file di codice ThisAddIn. Il nuovo codice utilizza il modello a oggetti di PowerPoint per aggiungere una casella di testo a ciascuna nuova diapositiva. Per impostazione predefinita, nel file di codice ThisAddIn è contenuto il seguente codice generato:

Definizione parziale della classe ThisAddIn. Questa classe fornisce un punto di ingresso per il codice e consente di accedere al modello a oggetti di PowerPoint. Per ulteriori informazioni, vedere Programmazione di componenti aggiuntivi a livello di applicazione. Il resto della classe ThisAddIn è definito in un file di codice nascosto che non deve essere modificato.
Gestori eventi ThisAddIn_Startup e ThisAddIn_Shutdown. Questi gestori eventi vengono chiamati quando il componente aggiuntivo viene caricato e scaricato da PowerPoint. Possono essere utilizzati per inizializzare il componente aggiuntivo quando viene caricato e per liberare le risorse utilizzate dal componente aggiuntivo quando viene scaricato. Per ulteriori informazioni, vedere la classe Eventi nei progetti di Office.

Per aggiungere una casella di testo a ciascuna nuova diapositiva

Nel file di codice ThisAddIn, aggiungere il codice seguente alla classe ThisAddIn. Questo codice consente di definire un gestore eventi per l'evento PresentationNewSlide dell'oggetto Application.

Quando l'utente aggiunge una nuova diapositiva alla presentazione attiva, questo gestore eventi consente di aggiungere una casella di testo nella parte superiore della nuova diapositiva e di inserirvi del testo.

Private Sub Application_PresentationNewSlide(ByVal Sld As PowerPoint.Slide) _
    Handles Application.PresentationNewSlide
    Dim textBox As PowerPoint.Shape = Sld.Shapes.AddTextbox( _
        Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50)
    textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.")
End Sub

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.");
}

Se si utilizza C#, aggiungere il codice seguente al gestore eventi ThisAddIn_Startup. Questo codice è necessario per connettere il gestore eventi Application_PresentationNewSlide all'evento PresentationNewSlide.
```
this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);
```

Per modificare ciascuna nuova diapositiva, negli esempi di codice precedenti vengono utilizzati gli oggetti seguenti:

Campo Application della classe ThisAddIn. Il campo Application restituisce un oggetto Application che rappresenta l'istanza corrente di PowerPoint.
Parametro Sld del gestore eventi per l'evento PresentationNewSlide. Il parametro Sld è un oggetto Slide che rappresenta la nuova diapositiva. Per ulteriori informazioni, vedere Soluzioni PowerPoint.

Verifica del progetto

Quando il progetto viene compilato ed eseguito, verificare che la casella di testo venga visualizzata nelle nuove diapositive aggiunte a una presentazione.

Per verificare il progetto

Premere F5 per compilare ed eseguire il progetto.

Quando si compila il progetto, il codice viene compilato in un assembly che viene incluso nella cartella di output di compilazione del progetto. Visual Studio permette inoltre di creare un insieme di voci del Registro di sistema che consente a PowerPoint di individuare e caricare il componente aggiuntivo e di configurare le impostazioni di sicurezza nel computer di sviluppo in modo da consentire l'esecuzione del componente aggiuntivo. Per ulteriori informazioni, vedere Cenni preliminari sul processo di compilazione delle soluzioni Office.
In PowerPoint, aggiungere una nuova diapositiva alla presentazione attiva.
Verificare che il testo seguente venga aggiunto a una nuova casella di testo nella parte superiore della diapositiva.

Questo testo è stato aggiunto tramite codice.
Chiudere PowerPoint.

Pulitura del progetto

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

Per pulire il progetto

In Visual Studio, nel menu Compila, scegliere Pulisci soluzione.

Passaggi successivi

Una volta creato un componente aggiuntivo di base a livello di applicazione per PowerPoint, per acquisire ulteriori informazioni sullo sviluppo di componenti aggiuntivi è possibile consultare gli argomenti seguenti:

Attività di programmazione generali eseguibili nei componenti aggiuntivi per PowerPoint. Per ulteriori informazioni, vedere Programmazione di componenti aggiuntivi a livello di applicazione.
Utilizzo del modello a oggetti di PowerPoint. Per ulteriori 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 ulteriori informazioni, vedere Personalizzazione dell'interfaccia utente di Office.
Compilazione e debug di componenti aggiuntivi a livello di applicazione per PowerPoint. Per ulteriori informazioni, vedere Compilazione e debug delle soluzioni Office.
Distribuzione di componenti aggiuntivi a livello di applicazione per PowerPoint. Per ulteriori informazioni, vedere Distribuzione di soluzioni Office.