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

  • Artikel

Aktualisiert: Juli 2008

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

  • Projekte auf Anwendungsebene

Microsoft Office-Version

  • PowerPoint 2007

  • PowerPoint 2003

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

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 hierzu finden Sie unter Übersicht über die Entwicklung von Office-Projektmappen.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Erstellen eines PowerPoint-Add-In-Projekts für PowerPoint 2003 oder PowerPoint 2007

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

Vorbereitungsmaßnahmen

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

  • Visual Studio Tools for Office (eine optionale Komponente von Visual Studio 2008 Professional und Visual Studio Team System).

  • PowerPoint 2003 oder PowerPoint 2007

Visual Studio Tools for Office wird standardmäßig mit den aufgeführten Versionen von Visual Studio installiert. Wie Sie überprüfen können, ob die Software installiert ist, erfahren Sie unter Installieren von Visual Studio Tools for Office.

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 Bereich Projekttypen den Knoten Visual C# oder Visual Basic, und erweitern Sie dann Office.

  4. Wählen Sie den Ordner 2007, wenn Sie ein Add-In für PowerPoint 2007 entwickeln, oder wählen Sie den Ordner 2003, wenn Sie ein Add-In für PowerPoint 2003 entwickeln.

  5. Wählen Sie im Bereich Vorlagen die Optionen PowerPoint 2007-Add-In oder PowerPoint 2003-Add-In aus.

  6. Geben Sie im Feld NameFirstPowerPointAddIn 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 hierzu finden Sie unter AddIn-Hostelement. 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 hierzu finden Sie unter Visual Studio Tools for Office-Projektereignisse.

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 der Microsoft.Office.Interop.PowerPoint.Application-Klasse.

    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 Microsoft.Office.Interop.PowerPoint.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 Microsoft.Office.Interop.PowerPoint.Slide-Objekt, das die neue Folie darstellt. Weitere Informationen hierzu 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 hierzu 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

Programmieren von Add-Ins auf Anwendungsebene

PowerPoint-Projektmappen

Anpassung der Office-Benutzeroberfläche

Übersicht über Visual Studio Tools for Office-Projektvorlagen

Referenz

Add-In-Projektvorlagen für 2003 Microsoft Office

Add-In-Projektvorlagen für 2007 Microsoft Office

Weitere Ressourcen

Erstellen und Debuggen von Office-Projektmappen

Bereitstellen von Office-Projektmappen

Änderungsprotokoll

Date

Versionsgeschichte

Grund

Juli 2008

Thema hinzugefügt

Informationsergänzung.