Dokumenthostelement

  • Artikel

Das Document Hostelement ist ein Typ, der den Document -Typ aus der primären Interopassembly für Word erweitert. Das Document -Hostelement stellt die gleichen Eigenschaften, Methoden und Ereignisse wie ein Document -Objekt bereit, es macht jedoch auch zusätzliche Ereignisse verfügbar und fungiert als Container für Hoststeuerelemente und Windows Forms-Steuerelemente.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte für Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

In Projekten auf Dokumentebene gibt es ein Document -Standardhostelement, das das Dokument im Projekt darstellt. In VSTO-Add-In-Projekten können Sie Document -Hostelemente zur Laufzeit generieren.

Grundlegendes zum Dokumenthostelement in Projekten auf Dokumentebene

Verwenden Sie die ThisDocument -Klasse, um auf das Dokument im Projekt zuzugreifen. Wenn Sie ein Projekt auf Dokumentebene erstellen, generiert Visual Studio die ThisDocument -Klasse, die als Kommunikationsverbindung zwischen Word und dem Anpassungscode dient. Über die ThisDocument -Klasse erhalten Sie Zugriff auf Member des Document -Hostelements, um grundlegende Aufgaben in der Anpassung auszuführen, z. B. das Ausführen von Code, wenn das Dokument geöffnet bzw. geschlossen wird. Sie können die Klasse auch verwenden, um dem Dokument Steuerelemente hinzuzufügen. Sie können Steuerelemente an Daten binden, Benutzerinformationen abfragen und auf Benutzeraktionen reagieren, indem Sie verschiedene Gruppen von Steuerelementen kombinieren und Code schreiben. Weitere Informationen finden Sie unter Anpassungen auf Dokumentebene auf Programmebene.

Die ThisDocument -Klasse stellt einen Ausgangspunkt bereit, an dem Sie mit dem Schreiben von Code im Projekt beginnen können. Da die Klasse die gleichen Eigenschaften, Methoden und Ereignisse wie das Document -Objekt in der primären Interop_Assembly für Word bereitstellt, können Sie auch mit ThisDocument auf das Word-Objektmodell zugreifen. Weitere Informationen finden Sie in der Übersicht über das Word-Objektmodell.

Einschränkungen des Dokumenthostelements in Projekten auf Dokumentebene

Ein Projekt auf Dokumentebene kann nur ein Document -Hostelement (die ThisDocument -Klasse) enthalten. Sie können dem Projekt zur Entwurfszeit keine neuen Document -Hostelemente hinzufügen, und Sie können zur Laufzeit von einer Anpassung auf Dokumentebene keine neuen Document -Hostelemente erstellen.

Wenn Sie zur Laufzeit ein neues Word-Dokument erstellen, ist es vom Typ Document. Da es kein Hostelement ist, kann es keine Hoststeuerelemente bzw. Windows Forms-Steuerelemente enthalten. Weitere Informationen zum Erstellen von Dokumenten zur Laufzeit finden Sie unter How to: Programmatically create new documents.

Grundlegendes zu Dokumenthostelementen in Projekten auf Anwendungsebene

In VSTO-Add-In-Projekten können Sie für jedes Dokument, das in Word geöffnet ist, zur Laufzeit ein Document -Hostelement erstellen. Sie können das Document -Hostelement verwenden, um dem zugeordneten Dokument Steuerelemente hinzuzufügen, oder um Ereignisse zu behandeln, die für Document -Objekte nicht verfügbar sind.

Verwenden Sie zum Generieren eines Document-Hostelements die GetVstoObject-Methode. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in VSTO-Add-Ins zur Laufzeit.

Zugehöriger Inhalt