Exemplarische Vorgehensweise: Erstellen Ihres ersten VSTO-Add-Ins für PowerPoint

  • Artikel

In dieser exemplarischen Vorgehensweise wird gezeigt, wie Sie ein VSTO-Add-In für Microsoft Office PowerPoint erstellen. Die Funktionen, die Sie in dieser Art von Projektmappe erstellen, sind für die Anwendung selbst verfügbar. Dabei spielt es keine Rolle, welche Präsentationen geöffnet sind. Weitere Informationen finden Sie unter Übersicht über die Entwicklung von Office-Lösungen (VSTO).

Gilt für: Die Informationen in diesem Thema gelten für VSTO-Add-In-Projekte für PowerPoint. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Erstellen eines PowerPoint-VSTO-Add-In-Projekts für PowerPoint

  • Schreiben von Code, der das PowerPoint-Objektmodell verwendet, um jeder neuen Folie ein Textfeld hinzuzufügen

  • Erstellen Sie das Projekt, und führen Sie es aus, um es zu testen.

  • Bereinigen des Projekts, sodass das VSTO-Add-In nicht mehr automatisch auf Ihrem Entwicklungscomputer ausgeführt wird

    Hinweis

    Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren der IDE.

Voraussetzungen

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen des Projekts

So erstellen Sie ein neues Projekt

  1. Starten Sie Visual Studio.

  2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  3. Erweitern Sie im Vorlagenbereich Visual C# oder Visual Basicund dann Office/SharePoint.

  4. Wählen Sie unter dem erweiterten Knoten Office/SharePoint den Knoten Office-Add-Ins aus.

  5. Wählen Sie in der Liste der Projektvorlagen ein PowerPoint-VSTO-Add-In-Projekt aus.

  6. Geben Sie im Feld "Name " den Namen "FirstPowerPointAddIn" ein.

  7. Klicken Sie auf OK.

    Visual Studio erstellt das FirstPowerPointAddIn-Projekt und öffnet die ThisAddIn-Codedatei im Editor.

Schreiben von Code, der jeder neuen Folie Text hinzufügt

Als Nächstes fügen Sie der Codedatei „ThisAddIn“ Code hinzu. Der neue Code, verwendet das PowerPoint-Objektmodell, um jeder neuen Folie ein Textfeld hinzuzufügen. Standardmäßig enthält die Codedatei „ThisAddIn“ den folgenden generierten Code:

  • Eine Teildefinition der ThisAddIn -Klasse. Diese Klasse stellt einen Einstiegspunkt für Ihren Code bereit und ermöglicht den Zugriff auf das Objektmodell von PowerPoint. Weitere Informationen finden Sie unter Programm-VSTO-Add-Ins. Der Erneute Standard der der ThisAddIn Klasse wird in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.

  • Die Ereignishandler ThisAddIn_Startup und ThisAddIn_Shutdown . Diese Ereignishandler werden aufgerufen, wenn Ihr VSTO-Add-In von PowerPoint geladen und entladen wird. Verwenden Sie diese Ereignishandler zum Initialisieren des VSTO-Add-Ins, wenn es geladen wird, und zum Bereinigen der vom VSTO-Add-In verwendeten Ressourcen, wenn es entladen wird. Weitere Informationen finden Sie unter "Ereignisse in Office-Projekten".

So fügen Sie jeder neuen Folie ein Textfeld hinzu

  1. Fügen Sie in der Codedatei „ThisAddIn“ der ThisAddIn -Klasse den folgenden Code hinzu. Dieser Code definiert einen Ereignishandler für das Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide-Ereignis des Application-Objekts .

    Wenn der Benutzer der aktiven Präsentation eine neue Folie hinzufügt, fügt dieser Ereignishandler oben auf der neuen Folie ein Textfeld hinzu und fügt Text in das Textfeld ein.

    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. Wenn Sie C# verwenden, fügen Sie dem ThisAddIn_Startup -Ereignishandler den folgenden Code hinzu. Dieser Code ist erforderlich, um den Application_PresentationNewSlide Ereignishandler mit dem ereignis Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide-Ereignis zu verbinden.

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

    Zum Ändern der einzelnen neuen Folien wurden in den vorherigen Codebeispielen die folgenden Objekte verwendet:

Testen des Projekts

Überprüfen Sie, wenn Sie das Projekt erstellen und ausführen, ob in neuen Folien, die Sie einer Präsentation hinzufügen, das Textfeld angezeigt wird.

So testen Sie das Projekt

  1. Drücken Sie F5 , um das Projekt zu erstellen und auszuführen.

    Wenn Sie das Projekt erstellen, wird der Code in eine Assembly kompiliert, die in den Buildausgabeordner des Projekts eingefügt wird. Visual Studio erstellt auch einen Satz von Registrierungseinträgen, mit deren Hilfe PowerPoint das VSTO-Add-In ermitteln und laden kann. Die Sicherheitseinstellungen auf dem Entwicklungscomputer werden so konfiguriert, dass das VSTO-Add-In ausgeführt werden kann. Weitere Informationen finden Sie unter Erstellen von Office-Lösungen.

  2. Fügen Sie in PowerPoint der aktiven Präsentation eine neue Folie hinzu.

  3. Stellen Sie sicher, dass einem neuen Textfeld am oberen Rand der Folie der folgende Text hinzugefügt wird.

    Dieser Text wurde per Code hinzugefügt.

  4. Schließen Sie PowerPoint.

Bereinigen des Projekts

Wenn Sie die Entwicklung eines Projekts abgeschlossen haben, entfernen Sie die VSTO-Add-In-Assembly, die Registrierungseinträge und die Sicherheitseinstellungen vom Entwicklungscomputer. Andernfalls wird das VSTO-Add-In jedes Mal ausgeführt, wenn Sie PowerPoint auf dem Entwicklungscomputer öffnen.

So bereinigen Sie das Projekt

  1. Klicken Sie in Visual Studio im Menü Build auf Projektmappe bereinigen.

Nächste Schritte

Nachdem Sie nun ein einfaches VSTO-Add-In für PowerPoint erstellt haben, können Sie in den folgenden Themen mehr über die Entwicklung von VSTO-Add-Ins erfahren:

  • Allgemeine Programmieraufgaben, die Sie in VSTO-Add-Ins für PowerPoint ausführen können. Weitere Informationen finden Sie unter Programm-VSTO-Add-Ins.

  • Verwenden des Objektmodells von PowerPoint. Weitere Informationen finden Sie unter PowerPoint-Lösungen.

  • Anpassen der Benutzeroberfläche (UI) von PowerPoint beispielsweise durch das Hinzufügen einer benutzerdefinierten Registerkarte zum Menüband oder durch das Erstellen eines eigenen benutzerdefinierten Aufgabenbereichs. Weitere Informationen finden Sie in der Anpassung der Office-Benutzeroberfläche.

  • Erstellen und Debuggen von VSTO-Add-Ins für PowerPoint. Weitere Informationen finden Sie unter Erstellen von Office-Lösungen.

  • Bereitstellen von VSTO-Add-Ins für PowerPoint. Weitere Informationen finden Sie unter Bereitstellen einer Office-Lösung.

Zugehöriger Inhalt