Exemplarische Vorgehensweise: Erstellen des ersten Add-Ins auf Anwendungsebene für PowerPoint
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
Microsoft Office-Version
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
Starten Sie Visual Studio.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Erweitern Sie im Bereich Projekttypen den Knoten Visual C# oder Visual Basic, und erweitern Sie dann Office.
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.
Wählen Sie im Bereich Vorlagen die Optionen PowerPoint 2007-Add-In oder PowerPoint 2003-Add-In aus.
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 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
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."); }
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
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.
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.
Dieser Text wurde durch Code hinzugefügt.
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 hierzu finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.
Verwenden des PowerPoint-Objektmodells. Weitere Informationen hierzu finden Sie unter PowerPoint-Projektmappen.
Anpassen der Benutzeroberfläche von PowerPoint, beispielsweise durch Hinzufügen einer benutzerdefinierten Registerkarte zur Multifunktionsleiste oder durch Erstellen eines eigenen benutzerdefinierten Aufgabenbereichs. Weitere Informationen hierzu finden Sie unter Anpassung der Office-Benutzeroberfläche.
Erstellen und Debuggen von Add-Ins auf Anwendungsebene für PowerPoint. Weitere Informationen hierzu finden Sie unter Erstellen und Debuggen von Office-Projektmappen.
Bereitstellen von Add-Ins auf Anwendungsebene für PowerPoint. Weitere Informationen hierzu finden Sie unter Bereitstellen von Office-Projektmappen.
Siehe auch
Konzepte
Programmieren von Add-Ins auf Anwendungsebene
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. |