Condividi tramite

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

  • Articolo

Aggiornamento: Luglio 2008

Si applica a

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

  • Progetti a livello di applicazione

Versione Microsoft Office

  • PowerPoint 2007

  • PowerPoint 2003

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

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.

Vengono illustrate le attività seguenti:

  • Creazione di un progetto componente aggiuntivo per PowerPoint 2003 o 2007.

  • 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.

Prerequisiti

Per completare la procedura dettagliata è necessario disporre dei componenti elencati di seguito.

  • Visual Studio Tools per Office°(componente facoltativo di Visual Studio 2008 Professional e Visual Studio Team System).

  • PowerPoint 2003 o 2007.

Per impostazione predefinita, Visual Studio Tools per Office viene installato con le versioni di Visual Studio elencate. Per controllare se è installato nel computer in uso, vedere Installazione di Visual Studio Tools per Office.

Creazione del progetto

Per creare un nuovo progetto

  1. Avviare Visual Studio.

  2. Scegliere Nuovo dal menu File, quindi scegliere Progetto.

  3. Nel riquadro Tipi progetto, espandere Visual C# o Visual Basic, quindi Office.

  4. Se si sviluppa un componente aggiuntivo per PowerPoint 2007, selezionare la cartella 2007. Se invece si sviluppa un componente aggiuntivo per PowerPoint 2003, selezionare la cartella 2003.

  5. Nel riquadro Modelli, selezionare Componente aggiuntivo per PowerPoint 2007 o Componente aggiuntivo per PowerPoint 2003.

  6. Nella casella Nome digitare FirstPowerPointAddIn.

  7. 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 la classe Elementi host di componenti aggiuntivi. 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 di progetti Visual Studio Tools per Office.

Per aggiungere una casella di testo a ciascuna nuova diapositiva

  1. Nel file di codice ThisAddIn, aggiungere il codice seguente alla classe ThisAddIn. Questo codice consente di definire un gestore eventi per l'evento PresentationNewSlide della classe Microsoft.Office.Interop.PowerPoint.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.");
}

  2. 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 Microsoft.Office.Interop.PowerPoint.Application che rappresenta l'istanza corrente di PowerPoint.

  • Parametro Sld del gestore eventi per l'evento PresentationNewSlide. Il parametro Sld è un oggetto Microsoft.Office.Interop.PowerPoint.Slide che rappresenta la nuova diapositiva. Per ulteriori informazioni, vedere la classe 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

  1. 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 la classe Cenni preliminari sul processo di generazione delle soluzioni Office.

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

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

    Questo testo è stato aggiunto tramite codice.

  4. 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:

Vedere anche

Concetti

Programmazione di componenti aggiuntivi a livello di applicazione

Soluzioni PowerPoint

Personalizzazione dell'interfaccia utente di Office

Cenni preliminari sui modelli di progetti di Visual Studio Tools per Office

Riferimenti

Modelli di progetto di componente aggiuntivo per Microsoft Office 2003

Modelli di progetto di componente aggiuntivo per Microsoft Office 2007

Altre risorse

Compilazione e debug delle soluzioni Office

Distribuzione di soluzioni Office

Cronologia delle modifiche

Date

History

Motivo

Luglio 2008

Argomento aggiunto.

Miglioramento delle informazioni.