Dela via

Genomgång: Skapa ditt första VSTO-tillägg för PowerPoint

Den här genomgången visar hur du skapar ett VSTO-tillägg för Microsoft Office PowerPoint. De funktioner som du skapar i den här typen av lösning är tillgängliga för själva programmet, oavsett vilka presentationer som är öppna. Mer information finns i Översikt över utveckling av Office-lösningar (VSTO).

Gäller för: Informationen i det här avsnittet gäller för VSTO-tilläggsprojekt för PowerPoint. Mer information finns i Funktioner som är tillgängliga efter Office-program och projekttyp.

I den här genomgången tas följande aktiviteter upp:

  • Skapa ett PowerPoint VSTO-tilläggsprojekt för PowerPoint.

  • Skriva kod som använder objektmodellen i PowerPoint för att lägga till en textruta i varje ny bild.

  • Skapa och köra projektet för att testa det.

  • Rensa projektet så att VSTO-tillägget inte längre körs automatiskt på utvecklingsdatorn.

    Anmärkning

    Datorn kan visa olika namn eller platser för vissa av Visual Studio-användargränssnittselementen i följande instruktioner. Den Visual Studio-utgåva som du har och de inställningar som du använder avgör dessa element. Mer information finns i Anpassa IDE.

Förutsättningar

Du behöver följande komponenter för att slutföra den här genomgången:

Skapa projektet

Skapa ett nytt projekt

  1. Starta Visual Studio.

  2. Peka på Nytt på Arkiv-menyn och klicka sedan på Projekt.

  3. I fönstret Mallar expanderar du Visual C# eller Visual Basic och expanderar sedan Office/SharePoint.

  4. Under den expanderade Noden Office/SharePoint väljer du noden Office-tillägg .

  5. I listan över projektmallar väljer du ett PowerPoint VSTO-tilläggsprojekt.

  6. I rutan Namn skriver du FirstPowerPointAddIn.

  7. Klicka på OK.

    Visual Studio skapar Projektet FirstPowerPointAddIn och öppnar kodfilen ThisAddIn i redigeraren.

Skriva kod som lägger till text i varje ny bild

Lägg sedan till kod i kodfilen ThisAddIn. Den nya koden använder objektmodellen i PowerPoint för att lägga till en textruta i varje ny bild. Kodfilen ThisAddIn innehåller som standard följande genererade kod:

  • En partiell definition av ThisAddIn klassen. Den här klassen tillhandahåller en startpunkt för din kod och ger åtkomst till objektmodellen i PowerPoint. Mer information finns i Program VSTO-tillägg. Resten av ThisAddIn klassen definieras i en dold kodfil som du inte bör ändra.

  • Händelsehanterarna ThisAddIn_Startup och ThisAddIn_Shutdown . Dessa händelsehanterare anropas när PowerPoint läser in och tar bort ditt VSTO-tillägg. Använd dessa händelsehanterare för att initiera DITT VSTO-tillägg när det läses in och för att rensa resurser som används av VSTO-tillägget när det tas bort. Mer information finns i Händelser i Office-projekt.

Så här lägger du till en textruta i varje ny bild

  1. I kodfilen ThisAddIn lägger du till följande kod i ThisAddIn klassen. Den här koden definierar en händelsehanterare för händelsen Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide för programobjektet .

    När användaren lägger till en ny bild i den aktiva presentationen lägger händelsehanteraren till en textruta överst i den nya bilden och lägger till text i textrutan.

    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. Om du använder C# lägger du till följande kod i ThisAddIn_Startup händelsehanteraren. Den här koden krävs för att ansluta Application_PresentationNewSlide händelsehanteraren till händelsen Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide .

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

    Om du vill ändra varje ny bild använder de föregående kodexemplen följande objekt:

Testa projektet

När du skapar och kör projektet ska du kontrollera att textfältet visas i nya bilder som läggs till i en presentation.

Så här testar du projektet

  1. Tryck på F5 för att skapa och köra projektet.

    När du skapar projektet kompileras koden till en sammansättning som placeras i utdatamappen för projektet. Visual Studio skapar också en uppsättning registerposter som gör att PowerPoint kan identifiera och läsa in VSTO-tillägget och konfigurerar säkerhetsinställningarna på utvecklingsdatorn så att VSTO-tillägget kan köras. Mer information finns i Skapa Office-lösningar.

  2. Lägg till en ny bild i den aktiva presentationen i PowerPoint.

  3. Kontrollera att följande text läggs till i en ny textruta överst i bilden.

    Den här texten har lagts till med hjälp av kod.

  4. Stäng PowerPoint.

Rensa projektet

När du har utvecklat ett projekt tar du bort VSTO-tilläggssammansättningen, registerposterna och säkerhetsinställningarna från utvecklingsdatorn. Annars körs VSTO-tillägget varje gång du öppnar PowerPoint på utvecklingsdatorn.

Så här rensar du projektet

  1. I Visual Studio går du till menyn Skapa och klickar på Rensa lösning.

Nästa steg

Nu när du har skapat ett grundläggande VSTO-tillägg för PowerPoint kan du lära dig mer om hur du utvecklar VSTO-tillägg från följande ämnen:

Relaterat innehåll