Dokumenthostelement
Das Document-Hostelement ist ein Typ, der den Microsoft.Office.Interop.Word.Document-Typ von der primären Interopassembly für Word erweitert. Das Document-Hostelement stellt die gleichen Eigenschaften, Methoden und Ereignisse wie ein Microsoft.Office.Interop.Word.Document-Objekt bereit, es macht jedoch auch zusätzliche Ereignisse verfügbar und fungiert als Container für Hoststeuerelemente und Windows Forms-Steuerelemente.
Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und auf Anwendungsebene für Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.
In Projekten auf Dokumentebene gibt es ein Document-Standardhostelement, das das Dokument im Projekt darstellt. In Projekten auf Anwendungsebene 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 mit der Klasse dem Dokument auch Steuerelemente und Smarttags hinzufügen. Sie können Steuerelemente an Daten binden, Informationen vom Benutzer sammeln und auf Benutzeraktionen reagieren, indem Sie verschiedene Gruppen von Steuerelementen kombinieren und Code schreiben. Weitere Informationen finden Sie unter Programmieren von Anpassungen auf Dokumentebene.
Tipp
Smarttags sind in Excel 2010 und Word 2010 veraltet. Weitere Informationen finden Sie unter Übersicht über Smarttags.
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 Microsoft.Office.Interop.Word.Document-Objekt in der primären Interopassembly für Word bereitstellt, können Sie auch mit ThisDocument auf das Word-Objektmodell zugreifen. Weitere Informationen finden Sie unter Ü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 Microsoft.Office.Interop.Word.Document. Da es kein Hostelement ist, kann es keine Hoststeuerelemente bzw. Windows Forms-Steuerelemente enthalten. Weitere Informationen über das Erstellen von Dokumenten zur Laufzeit finden Sie unter Gewusst wie: Erstellen neuer Dokumente.
Grundlegendes zu Dokumenthostelementen in Projekten auf Anwendungsebene
In Projekten auf Anwendungsebene können Sie für jedes Dokument, das in Word geöffnet ist, zur Laufzeit ein Document-Hostelement erstellen. Sie können mit dem Document-Hostelement dem zugeordneten Dokument Steuerelemente und Smarttags hinzufügen oder Ereignisse behandeln, die in Microsoft.Office.Interop.Word.Document-Objekten 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 Add-Ins auf Anwendungsebene zur Laufzeit.
Siehe auch
Konzepte
Übersicht über Hostelemente und Hoststeuerelemente
Automatisieren von Word mithilfe von erweiterten Objekten
Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen
Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit