Exemplarische Vorgehensweise: Erstellen der ersten Anpassung auf Dokumentebene für Word
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 einführenden exemplarischen Vorgehensweise wird Ihnen erläutert, wie Sie eine Anpassung auf Dokumentebene für Microsoft Office Word erstellen können. Die Features, die Sie in dieser Art von Projektmappe erstellen, sind nur für die Anwendung verfügbar, wenn ein bestimmtes Dokument geöffnet ist. Sie können Anpassungen auf Dokumentebene nicht verwenden, um anwendungsweite Änderungen vorzunehmen, z. B. das Anzeigen einer neuen Multifunktionsleisten-Registerkarte, wenn ein beliebiges Dokument geöffnet ist.
In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:
Erstellen eines Word-Dokumentprojekts für Word 2003 oder Word 2007
Hinzufügen von Text zu einem in Visual Studio Designer gehosteten Dokument
Schreiben von Code, der das Word-Objektmodell zum Hinzufügen von Text zu einem angepassten Dokument beim Öffnen des Dokuments verwendet
Erstellen und Ausführen des Projekts zum Testen
Bereinigen des Projekts zum Entfernen nicht benötigter Builddateien und Sicherheitseinstellungen vom Entwicklungscomputer
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).
Word 2003 oder Word 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 in Installieren von Visual Studio Tools for Office.
Erstellen des Projekts
So erstellen Sie ein neues Word-Dokumentprojekt in Visual Studio
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 eine Anpassung für Word 2007 entwickeln, oder wählen Sie den Ordner 2003, wenn Sie eine Anpassung für Word 2003 entwickeln.
Hinweis: Wenn Sie eine Anpassung auf Dokumentebene für eine bestimmte Word-Version entwickeln, muss diese Version auf Ihrem Entwicklungscomputer installiert sein.
Wählen Sie im Bereich VorlagenWord 2003-Dokument oder Word 2007-Dokument aus.
Geben Sie im Feld Name den Namen FirstDocumentCustomization ein.
Klicken Sie auf OK.
Der Projekt-Assistent aus Visual Studio Tools for Office wird geöffnet.
Wählen Sie Neues Dokument erstellen aus, und klicken Sie auf OK.
Visual Studio erstellt das Projekt FirstDocumentCustomization und fügt das Dokument FirstDocumentCustomization und die Codedatei ThisDocument dem Projekt hinzu. Das Dokument FirstDocumentCustomization wird automatisch im Designer geöffnet.
Schließen und erneutes Öffnen des Dokuments im Designer
Wenn Sie das Dokument im Designer absichtlich oder versehentlich schließen, während Sie das Projekt entwickeln, können Sie es erneut öffnen.
So schließen Sie das Dokument im Designer und öffnen es erneut
Schließen Sie das Dokument, indem Sie auf die Schaltfläche Schließen (X) im Designerfenster klicken.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Codedatei ThisDocument, und klicken Sie danach auf Ansicht-Designer.
- oder -
Doppelklicken Sie im Projektmappen-Explorer auf die Codedatei ThisDocument.
Hinzufügen von Text zum Dokument im Designer
Sie können die Benutzeroberfläche Ihrer Anpassung gestalten, indem Sie das geöffnete Dokument im Designer ändern. Sie können beispielsweise Text, Tabellen oder Word-Steuerelemente hinzufügen. Weitere Informationen zur Verwendung des Designers finden Sie unter Übersicht über Office-Dokumente in der Visual Studio-Umgebung.
So fügen Sie mit dem Designer dem Dokument Text hinzu
Geben Sie in das geöffnete Dokument den folgenden Text ein.
This text was added by using the designer.
Programmgesteuertes Hinzufügen von Code zum Dokument
Fügen Sie anschließend der ThisDocument-Codedatei Code hinzu. Der neue Code verwendet das Word-Objektmodell, um dem Dokument einen zweiten Textabsatz hinzuzufügen. Standardmäßig enthält die ThisDocument-Codedatei den folgenden generierten Code:
Eine partielle Definition der ThisDocument-Klasse, die das Programmiermodell des Dokuments darstellt und den Zugriff auf das Word-Objektmodell bereitstellt. Weitere Informationen finden Sie unter Dokumenthostelement und unter Übersicht über das Word-Objektmodell. Der Rest der ThisDocument-Klasse ist in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.
Der ThisDocument_Startup-Ereignishandler und der ThisDocument_Shutdown-Ereignishandler. Diese Ereignishandler werden aufgerufen, wenn das Dokument geöffnet und geschlossen wird. Verwenden Sie diese Ereignishandler, um die Anpassung beim Öffnen des Dokuments zu initialisieren und um beim Schließen des Dokuments von der Anwendung verwendete Ressourcen zu bereinigen. Weitere Informationen hierzu finden Sie unter Visual Studio Tools for Office-Projektereignisse.
So fügen Sie mit Code dem Dokument einen zweiten Textabsatz hinzu
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ThisDocument, und klicken Sie dann auf Code anzeigen.
Die Codedatei wird in Visual Studio geöffnet.
Ersetzen Sie den ThisDocument_Startup-Ereignishandler durch folgenden Code. Beim Öffnen des Dokuments wird mit diesem Code dem Dokument ein zweiter Textabsatz hinzugefügt.
Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup Me.Paragraphs(1).Range.InsertParagraphAfter() Me.Paragraphs(2).Range.Text = "This text was added by using code." End Sub
private void ThisDocument_Startup(object sender, System.EventArgs e) { this.Paragraphs[1].Range.InsertParagraphAfter(); this.Paragraphs[2].Range.Text = "This text was added by using code."; }
Hinweis: In diesem Code wird der Indexwert 1 verwendet, um auf den ersten Absatz in der Paragraphs-Eigenschaft zuzugreifen. Auch wenn Visual Basic und Visual C# nullbasierte Arrays verwenden, sind die unteren Arraybegrenzungen in den meisten Auflistungen des Word-Objektmodells 1. Weitere Informationen finden Sie unter Programmieren mit Visual Basic im Vergleich zu C#.
Testen des Projekts
So testen Sie das Dokument
Drücken Sie F5, um das Projekt zu erstellen und auszuführen.
Beim Erstellen des Projekts wird der Code in eine Assembly kompiliert, die mit dem Dokument verknüpft ist. Visual Studio legt eine Kopie des Dokuments und der Assembly im Buildausgabeordner für das Projekt ab und konfiguriert die Sicherheitseinstellungen auf dem Entwicklungscomputer, damit die Anpassung ausgeführt werden kann. Weitere Informationen hierzu finden Sie unter Übersicht über das Erstellen von Office-Projektmappen.
Überprüfen Sie, ob Sie im Dokument den folgenden Text sehen.
This text was added by using the designer.
This text was added by using code.
Schließen Sie das Dokument.
Bereinigen des Projekts
Wenn Sie die Entwicklung eines Projekts abgeschlossen haben, sollten Sie die Dateien im Buildausgabeordner und die durch den Buildprozess erstellten Sicherheitseinstellungen entfernen.
So bereinigen Sie das abgeschlossene Projekt auf dem Entwicklungscomputer
- Klicken Sie in Visual Studio im Menü Erstellen auf Projektmappe bereinigen.
Nächste Schritte
Nachdem Sie nun eine grundlegende Anpassung auf Dokumentebene für Word erstellt haben, können Sie mehr über die Entwicklung von Anpassungen in den folgenden Themen erfahren:
Allgemeine Programmierungsaufgaben, die Sie in Anpassungen auf Dokumentebene ausführen können: Programmieren von Anpassungen auf Dokumentebene.
Programmieren von Aufgaben, die für Anpassungen auf Dokumentebene für Word spezifisch sind: Entwicklung von Anpassungen auf Dokumentebene für Word.
Verwenden des Word-Objektmodells: Übersicht über das Word-Objektmodell.
Anpassen der Benutzeroberfläche von Word, beispielsweise durch Hinzufügen einer benutzerdefinierten Registerkarte zu der Multifunktionsleiste oder durch Erstellen eines eigenen benutzerdefinierten Aktionsbereichs: Anpassung der Office-Benutzeroberfläche.
Verwenden der von Visual Studio Tools for Office bereitgestellten erweiterten Word-Objekte zum Ausführen von Aufgaben, die mit dem Word-Objektmodell nicht möglich sind (z. B. Hosten verwalteter Steuerelemente in Dokumenten und Binden von Word-Steuerelementen an Daten mit dem Datenbindungsmodell von Windows Forms): Automatisieren von Word mithilfe von erweiterten Objekten.
Erstellen und Debuggen von Anpassungen auf Dokumentebene für Word: Erstellen und Debuggen von Office-Projektmappen.
Bereitstellen von Anpassungen auf Dokumentebene für Word: Bereitstellen von Office-Projektmappen.
Siehe auch
Konzepte
Übersicht über die Entwicklung von Office-Projektmappen
Entwicklung von Anpassungen auf Dokumentebene für Word
Programmieren von Anpassungen auf Dokumentebene
Übersicht über das Word-Objektmodell
Automatisieren von Word mithilfe von erweiterten Objekten
Anpassung der Office-Benutzeroberfläche
Übersicht über Visual Studio Tools for Office-Projektvorlagen
Referenz
Weitere Ressourcen
Erstellen und Debuggen von Office-Projektmappen
Bereitstellen von Office-Projektmappen
Änderungsprotokoll
Datum |
Versionsgeschichte |
Grund |
---|---|---|
Juli 2008 |
Thema hinzugefügt. |
Informationsergänzung. |