Exemplarische Vorgehensweise: Erstellen des ersten Add-Ins auf Anwendungsebene für PowerPoint

Artikel
02/26/2013

In dieser exemplarischen Vorgehensweise wird erläutert, wie Sie ein Add-In auf Anwendungsebene für Microsoft Office PowerPoint erstellen.Die Features, die Sie in dieser Art von Projektmappe erstellen, sind für die Anwendung selbst verfügbar, unabhängig davon, welche Präsentationen geöffnet sind.Weitere Informationen finden Sie unter Übersicht über die Entwicklung von Office-Projektmappen.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Anwendungsebene für PowerPoint 2013 und PowerPoint 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

Erstellen eines PowerPoint-Add-In-Projekts für PowerPoint
Schreiben von Code, der das PowerPoint-Objektmodell zum Hinzufügen eines Textfelds auf jeder neuen Folie verwendet
Erstellen und Ausführen des Projekts zum Testen
Bereinigen des Projekts, damit das Add-In nicht mehr automatisch auf dem Entwicklungscomputer ausgeführt wird

Hinweis
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Link zu Video Eine entsprechende Videodemo finden Sie im Thema zum Erstellen eines Add-Ins für Microsoft PowerPoint (möglicherweise in englischer Sprache).

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

Eine Version von Visual Studio 2012, die die Microsoft Office-Entwicklungstools einschließt. Weitere Informationen finden Sie unter [Konfigurieren eines Computers zum Entwickeln von Office-Lösungen](bb398242\(v=vs.110\).md).

PowerPoint 2013 oder PowerPoint 2010.

Erstellen des Projekts

So erstellen Sie ein neues Projekt

Starten Sie Visual Studio.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Erweitern Sie im Vorlagenbereich den Visual C# oder Visual Basic, und erweitern Sie dann Office/SharePoint.
unter dem erweiterten Knoten Office/SharePoint wählen Sie den Knoten Office-Add-Ins aus.
In der Liste der Projektvorlagen, von Auswahl- PowerPoint 2010-Add-In oder von PowerPoint_15_short.
Geben Sie im Feld NameFirstPowerPointAddIn ein.
Klicken Sie auf OK.

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

Schreiben von Code zum Einfügen von Text auf jeder neuen Folie

Fügen Sie anschließend der ThisAddIn-Codedatei Code hinzu.Der neue Code verwendet das PowerPoint-Objektmodell zum Hinzufügen eines Textfelds auf jeder neuen Folie.Standardmäßig enthält die ThisAddIn-Codedatei den folgenden generierten Code:

Eine partielle Definition der ThisAddIn-Klasse.Diese Klasse liefert einen Einstiegspunkt für den Code und ermöglicht den Zugriff auf das PowerPoint-Objektmodell.Weitere Informationen finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.Der Rest der ThisAddIn-Klasse ist in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.
Der ThisAddIn_Startup-Ereignishandler und der ThisAddIn_Shutdown-Ereignishandler.Diese Ereignishandler werden aufgerufen, wenn PowerPoint das Add-In lädt und entlädt.Verwenden Sie diese Ereignishandler, um das Add-In zu initialisieren, wenn es geladen wird, und um beim Entladen die Ressourcen zu bereinigen, die vom Add-In verwendet werden.Weitere Informationen finden Sie unter Ereignisse in Office-Projekten.

So fügen Sie jeder neuen Folie ein Textfeld hinzu

Fügen Sie in der ThisAddIn-Codedatei der ThisAddIn-Klasse folgenden Code hinzu.Dieser Code definiert einen Ereignishandler für das PresentationNewSlide-Ereignis des Application-Objekts.

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

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

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 PresentationNewSlide-Ereignis zu verbinden.
```
this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);
```

Um jede neue Folie zu ändern, werden in den vorherigen Codebeispielen die folgenden Objekte verwendet:

Das Application-Feld der ThisAddIn-Klasse.Das Application-Feld gibt ein Application-Objekt zurück, das die aktuelle Instanz von PowerPoint darstellt.
Der Sld-Parameter des Ereignishandlers für das PresentationNewSlide-Ereignis.Der Sld-Parameter ist ein Slide-Objekt, das die neue Folie darstellt.Weitere Informationen finden Sie unter PowerPoint-Projektmappen.

Testen des Projekts

Überprüfen Sie, dass beim Erstellen und Ausführen des Projekts das Textfeld in den neuen Folien angezeigt wird, die zu einer Präsentation hinzugefügt werden.

So testen Sie das Projekt

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

Beim Erstellen des Projekts wird der Code in eine Assembly kompiliert, die im Buildausgabeordner für das Projekt gespeichert wird.Visual Studio erstellt auch einen Satz von Registrierungseinträgen, die es PowerPoint ermöglichen, das Add-In aufzufinden und zu laden, und konfiguriert die Sicherheitseinstellungen auf dem Entwicklungscomputer, damit das Add-In ausgeführt werden kann.Weitere Informationen finden Sie unter Aktualisieren von Office-Projektmappen.
Fügen Sie in PowerPoint in der aktiven Präsentation eine neue Folie hinzu.
Überprüfen Sie, ob der folgende Text in einem neuen Textfeld oben auf der Folie eingefügt wurde.

This text was added by using code.
Schließen Sie PowerPoint.

Bereinigen des Projekts

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

So bereinigen Sie das Projekt

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

Nächste Schritte

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

Allgemeine Programmierungsaufgaben, die Sie in Add-Ins für PowerPoint ausführen können.Weitere Informationen finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.
Verwenden des PowerPoint-Objektmodells.Weitere Informationen finden Sie unter PowerPoint-Projektmappen.
Anpassen der Benutzeroberfläche von PowerPoint, beispielsweise durch Hinzufügen einer benutzerdefinierten Registerkarte zum Menüband oder durch Erstellen eines eigenen benutzerdefinierten Aufgabenbereichs.Weitere Informationen finden Sie unter Anpassung der Office-Benutzeroberfläche.
Erstellen und Debuggen von Add-Ins auf Anwendungsebene für PowerPoint.Weitere Informationen finden Sie unter Aktualisieren von Office-Projektmappen.
Bereitstellen von Add-Ins auf Anwendungsebene für PowerPoint.Weitere Informationen finden Sie unter Bereitstellen einer Office-Projektmappe.