Freigeben über

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

  • Artikel

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 2007 and 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

Tipp

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 2010, die die Microsoft Office-Entwicklungstools einschließt. Weitere Informationen finden Sie unter [Konfigurieren eines Computers zum Entwickeln von Office-Lösungen](bb398242\(v=vs.100\).md).
  • PowerPoint 2007 oder PowerPoint 2010.

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 Basic, und erweitern Sie dann Office.

  4. Wählen Sie unter dem erweiterten Knoten Office die Option 2007 aus, wenn Sie PowerPoint 2007 installiert haben, oder wählen Sie den Knoten 2010 aus, wenn Sie PowerPoint 2010 installiert haben.

  5. Wählen Sie in der Liste der Projektvorlagen PowerPoint 2007-Add-In oder PowerPoint 2010-Add-In aus.

  6. Geben Sie im Feld Name FirstPowerPointAddIn ein.

  7. 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 jetzt 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 Ressourcen zu bereinigen, die vom Add-In verwendet werden, 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 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.");
}

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

  1. 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 Übersicht über das Erstellen von Office-Projektmappen.

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

  3. Überprüfen Sie, ob der folgende Text in einem neuen Textfeld oben auf der Folie eingefügt wurde.

    Dieser Text wurde durch Code hinzugefügt.

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

Siehe auch

Konzepte

PowerPoint-Projektmappen

Weitere Ressourcen

Programmieren von Add-Ins auf Anwendungsebene

Anpassung der Office-Benutzeroberfläche

Erstellen und Debuggen von Office-Projektmappen

Bereitstellen von Office-Projektmappen

Übersicht über Office-Projektvorlagen