Übersicht über das Word-ObjektmodellWord object model overview

Wenn Sie Word-Lösungen in Visual Studio entwickeln, interagieren Sie mit dem Word-Objektmodell.When you develop Word solutions in Visual Studio, you interact with the Word object model. Dieses Objektmodell besteht aus Klassen und Schnittstellen, die in der primären Interopassembly für Word bereitgestellt und im Namespace Microsoft.Office.Interop.Word definiert werden.This object model consists of classes and interfaces that are provided in the primary interop assembly for Word, and are defined in the Microsoft.Office.Interop.Word namespace.

Gilt für: Die Informationen in diesem Thema betreffen Projekte auf Dokument - Ebene und VSTO Add - in-Projekte für Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. Weitere Informationen finden Sie unter verfügbare Funktionen nach Office-Anwendung und Projekttyp.For more information, see Features available by Office application and project type.

Dieses Thema enthält eine kurze Übersicht über das Word-Objektmodell.This topic provides a brief overview of the Word object model. Informationen zu Ressourcen, in denen Sie mehr über das gesamte Word-Objektmodell erfahren können, finden Sie unter Verwenden der Dokumentation zum Word-Objektmodell.For resources where you can learn more about the entire Word object model, see Use the Word object model documentation.

Informationen zur Verwendung des Word-Objektmodells für bestimmte Aufgaben finden Sie unter den folgenden Themen:For information about using the Word object model to perform specific tasks, see the following topics:

Grundlegendes zum Word-ObjektmodellUnderstand the Word object model

Word stellt Hunderte von Objekten bereit, mit denen Sie interagieren können.Word provides hundreds of objects with which you can interact. Diese Objekte werden in einer Hierarchie angeordnet, die eng an die Benutzeroberfläche angelehnt ist.These objects are organized in a hierarchy that closely follows the user interface. An der Spitze dieser Hierarchie befindet sich das Application -Objekt.At the top of the hierarchy is the Application object. Dieses Objekt stellt die aktuelle Instanz von Word dar.This object represents the current instance of Word. Das Application -Objekt enthält die Document-, Selection-, Bookmark- und Range -Objekte.The Application object contains the Document, Selection, Bookmark, and Range objects. Jedes dieser Objekte verfügt über zahlreiche Methoden und Eigenschaften, auf die Sie zum Bearbeiten des Objekts und Interagieren mit dem Objekt zugreifen können.Each of these objects has many methods and properties that you can access to manipulate and interact with the object.

Die folgende Abbildung zeigt eine Ansicht dieser Objekte in der Hierarchie des Word-Objektmodells.The following illustration shows one view of these objects in the hierarchy of the Word object model.

Grafik zum Word-ObjektmodellWord Object Model graphic

Auf den ersten Blick scheinen sich die Objekte zu überlappen.At first glance, objects appear to overlap. Die Document - und Selection -Objekte sind beide Elemente des Application -Objekts, das Document -Objekt ist jedoch auch ein Element des Selection -Objekts.For example, the Document and Selection objects are both members of the Application object, but the Document object is also a member of the Selection object. Sowohl das Document - als auch das Selection -Objekt enthält Bookmark - und Range -Objekte.Both the Document and Selection objects contain Bookmark and Range objects. Die Überlappung ist vorhanden, weil es mehrere Möglichkeiten gibt, auf den gleichen Typ von Objekt zuzugreifen.The overlap exists because there are multiple ways you can access the same type of object. Angenommen, Sie wenden Formatierungen auf ein Range -Objekt an. Sie möchten jedoch ggf. auf den Bereich der aktuellen Auswahl, eines bestimmten Absatzes, eines Abschnitts oder auf das gesamte Dokument zugreifen.For example, you apply formatting to a Range object; but you may want to access the range of the current selection, of a particular paragraph, of a section, or of the entire document.

In den folgenden Abschnitten werden die Objekte der obersten Ebene und ihre Interaktion miteinander kurz beschrieben.The following sections briefly describe the top-level objects and how they interact with each other. Dazu gehören die folgenden fünf Objekte:These objects include the following five:

  • AnwendungsobjektApplication object

  • Document-ObjektDocument object

  • Selection-ObjektSelection object

  • Range-ObjektRange object

  • Bookmark-ObjektBookmark object

    Zusätzlich zum Word-Objektmodell stellen Office-Projekte in Visual Studio Hostelemente und Hoststeuerelemente bereit, die im Word-Objektmodell einige Objekte erweitern.In addition to the Word object model, Office projects in Visual Studio provide host items and host controls that extend some objects in the Word object model. Hostelemente und Hoststeuerelemente verhalten sich wie die Word-Objekte, die sie erweitern, verfügen jedoch auch über zusätzliche Funktionen, z. B. Datenbindungsfunktionen und zusätzliche Ereignisse.Host items and host controls behave like the Word objects they extend, but they also have additional functionality such as data-binding capabilities and extra events. Weitere Informationen finden Sie unter Automatisieren von Word mithilfe von erweiterten Objekten und Übersicht über Host Elemente und Host Steuerelemente.For more information, see Automate Word by using extended objects and Host items and host controls overview.

AnwendungsobjektApplication object

Das Application -Objekt stellt die Word-Anwendung dar und ist das übergeordnete Element aller anderen Objekte.The Application object represents the Word application, and is the parent of all of the other objects. Seine Elemente gelten normalerweise für Word als Ganzes.Its members usually apply to Word as a whole. Sie können seine Eigenschaften und Methoden zum Steuern der Word-Umgebung verwenden.You can use its properties and methods to control the Word environment.

In VSTO-Add-In-Projekten können Sie mithilfe des Application -Felds der Application -Klasse auf das ThisAddIn -Objekt zugreifen.In VSTO Add-in projects, you can access the Application object by using the Application field of the ThisAddIn class. Weitere Informationen finden Sie unter Program VSTO Add-ins.For more information, see Program VSTO Add-ins.

In Projekten auf Dokumentebene können Sie auf das Application -Objekt mithilfe der Eigenschaft Application der Klasse ThisDocument zugreifen.In document-level projects, you can access the Application object by using the Application property of the ThisDocument class.

Document-ObjektDocument object

Das Document -Objekt ist für die Programmierung von Word wesentlich.The Document object is central to programming Word. Es stellt ein Dokument und seinen gesamten Inhalt dar.It represents a document and all of its contents. Wenn Sie ein Dokument öffnen oder ein neues Dokument erstellen, erstellen Sie ein neues Document -Objekt, das der Auflistung Documents des Application -Objekts hinzugefügt wird.When you open a document or create a new document, you create a new Document object, which is added to the Documents collection of the Application object. Das Dokument, das den Fokus besitzt, wird als das aktive Dokument bezeichnet.The document that has the focus is called the active document. Es wird durch die Eigenschaft ActiveDocument des Application -Objekts dargestellt.It is represented by the ActiveDocument property of the Application object.

Die Office-Entwicklungstools in Visual Studio erweitern das Document -Objekt, indem sie den Document -Typ bereitstellen.The Office development tools in Visual Studio extend the Document object by providing the Document type. Dieser Typ ist ein Hostelement , das Ihnen den Zugriff auf alle Features eines Document -Objekts ermöglicht und zusätzliche Ereignisse sowie die Möglichkeit zum Hinzufügen verwalteter Steuerelemente hinzufügt.This type is a host item that gives you access to all features of a Document object, and adds additional events and the ability to add managed controls.

Wenn Sie ein Projekt auf Dokumentebene erstellen, können Sie auf Document -Elemente mithilfe der generierten Klasse ThisDocument in Ihrem Projekt zugreifen.When you create a document-level project, you can access Document members by using the generated ThisDocument class in your project. Können Sie auf Elemente des Document -Hostelements mithilfe der Schlüsselwörter Me oder this aus Code in der Klasse ThisDocument oder mithilfe von Globals.ThisDocument aus Code außerhalb der Klasse ThisDocument -Objekt zugreifen.You can access members of the Document host item by using the Me or this keywords from code in the ThisDocument class, or by using Globals.ThisDocument from code outside the ThisDocument class. Weitere Informationen finden Sie unter Program mieren von Anpassungen auf Dokument Ebene.For more information, see Program document-level customizations. Zum Auswählen des ersten Absatzes im Dokument verwenden Sie beispielsweise den folgenden Code.For example, to select the first paragraph in the document, use the following code.

Me.Paragraphs(1).Range.Select()
this.Paragraphs[1].Range.Select();

In VSTO-Add-In-Projekten können Sie Document -Hostelemente zur Laufzeit generieren.In VSTO Add-in projects, you can generate Document host items at run time. Sie können das generierte Hostelement zum Hinzufügen von Steuerelementen zum zugehörigen Dokument verwenden.You can use the generated host item to add controls to the associated document. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in VSTO-Add-Ins zur Laufzeit.For more information, see Extend Word documents and Excel workbooks in VSTO Add-ins at run time.

Selection-ObjektSelection object

Das Selection -Objekt stellt den Bereich dar, der zurzeit ausgewählt ist.The Selection object represents the area that is currently selected. Beim Ausführen eines Vorgangs in der Word-Benutzeroberfläche (z. B. Fettformatieren von Text) wählen Sie den Text aus oder markieren ihn, und wenden dann die Formatierung an.When you perform an operation in the Word user interface, such as bolding text, you select, or highlight the text and then apply the formatting. Das Selection -Objekt ist in einem Dokument immer vorhanden.The Selection object is always present in a document. Wenn nichts ausgewählt ist, stellt es die Einfügemarke dar.If nothing is selected, then it represents the insertion point. Darüber hinaus kann eine Auswahl mehrere Textblöcke umfassen, die nicht zusammenhängend sind.In addition, a selection can encompass multiple blocks of text that are not contiguous.

Range-ObjektRange object

Das Range -Objekt stellt einen zusammenhängenden Bereich in einem Dokument dar und wird durch eine Startzeichenposition und eine Endzeichenposition definiert.The Range object represents a contiguous area in a document, and is defined by a starting character position and an ending character position. Es besteht keine Einschränkung auf ein einzelnes Range -Objekt.You are not limited to a single Range object. Sie können mehrere Range -Objekte im gleichen Dokument definieren.You can define multiple Range objects in the same document. Ein Range -Objekt weist folgende Merkmale auf:A Range object has the following characteristics:

  • Es kann aus der Einfügemarke allein, einem Textbereich oder dem gesamten Dokument bestehen.It can consist of the insertion point alone, a range of text, or the entire document.

  • Es enthält nicht druckbare Zeichen wie z. B. Leerzeichen, Tabstoppzeichen und Absatzmarken.It includes non-printing characters such as spaces, tab characters, and paragraph marks.

  • Es kann sich um den Bereich handeln, der die aktuelle Auswahl dargestellt, oder es kann einen anderen Bereich als die aktuelle Auswahl darstellen.It can be the area represented by the current selection, or it can represent an area different from the current selection.

  • Es ist in einem Dokument im Gegensatz zu einer Auswahl, die immer sichtbar ist, nicht sichtbar.It is not visible in a document, unlike a selection, which is always visible.

  • Es wird nicht mit dem Dokument gespeichert und existiert nur, während der Code ausgeführt wird.It is not saved with a document and exists only while the code is running.

    Wenn Sie am Ende eines Bereichs Text einfügen, erweitert Word den Bereich automatisch so, dass der eingefügte Text berücksichtigt wird.When you insert text at the end of a range, Word automatically expands the range to include the inserted text.

Inhalts Steuerelement-ObjekteContent control objects

Ein ContentControl -Objekt bietet eine Möglichkeit, die Eingabe und die Darstellung von Text und anderen Typen von Inhalt in Word-Dokumenten zu steuern.A ContentControl provides a way for you to control the input and presentation of text and other types of content in Word documents. Ein ContentControl -Objekt kann verschiedene Typen von Benutzeroberflächen anzeigen, die für die Verwendung in Word-Dokumenten optimiert sind, z. B. ein Rich-Text-Steuerelement, eine Datumsauswahl oder ein Kombinationsfeld.A ContentControl can display several different types of UI that are optimized for use in Word documents, such as a rich text control, a date picker, or a combo box. Sie können auch ein ContentControl -Objekt verwenden, um zu verhindern, dass Benutzer Abschnitte des Dokuments oder der Vorlage bearbeiten können.You can also use a ContentControl to prevent users from editing sections of the document or template.

Visual Studio erweitert das ContentControl -Objekt in mehrere unterschiedliche Hoststeuerelemente.Visual Studio extends the ContentControl object into several different host controls. Während das ContentControl -Objekt jeden der verschiedenen Typen von Benutzeroberflächen anzeigen kann, die für Inhaltssteuerelemente verfügbar sind, stellt Visual Studio einen anderen Typ für jedes Inhaltssteuerelement bereit.Whereas the ContentControl object can display any of the different types of UI that are available for content controls, Visual Studio provides a different type for each content control. Beispielsweise können Sie ein RichTextContentControl -Objekt zum Erstellen eines Rich-Text-Steuerelements oder ein DatePickerContentControl -Objekt zum Erstellen einer Datumsauswahl verwenden.For example, you can use a RichTextContentControl to create a rich text control, or you can use a DatePickerContentControl to create a date picker. Diese Hoststeuerelemente verhalten sich wie das systemeigene ContentControl-Objekt, verfügen jedoch über zusätzliche Ereignisse und Datenbindungsfunktionen.These host controls behave like the native ContentControl, but they have additional events and data-binding capabilities. Weitere Informationen finden Sie unter Inhalts Steuerelemente.For more information, see Content controls.

Bookmark-ObjektBookmark object

Das Bookmark -Objekt stellt einen zusammenhängenden Bereich in einem Dokument mit einer Anfangsposition und einer Endposition dar.The Bookmark object represents a contiguous area in a document, with both a starting position and an ending position. Sie können Lesezeichen verwenden, um eine Position in einem Dokument zu markieren, oder als einen Container für Text in einem Dokument.You can use bookmarks to mark a location in a document, or as a container for text in a document. Ein Bookmark -Objekt kann aus der Einfügemarke bestehen oder so groß wie das gesamte Dokument sein.A Bookmark object can consist of the insertion point, or be as large as the entire document. Ein Bookmark -Objekt weist die folgenden Merkmale auf, die es vom Range -Objekt unterscheiden:A Bookmark has the following characteristics that set it apart from the Range object:

  • Sie können das Lesezeichen zur Entwurfszeit benennen.You can name the bookmark at design time.

  • Bookmark -Objekte werden mit dem Dokument gespeichert und daher nicht gelöscht, wenn der Code nicht mehr ausgeführt oder das Dokument geschlossen wird.Bookmark objects are saved with the document, and thus are not deleted when the code stops running or your document is closed.

  • Lesezeichen können ausgeblendet oder sichtbar gemacht werden, indem die Eigenschaft ShowBookmarks der Klasse View -Objekts auf false oder true.Bookmarks can be hidden or made visible by setting the ShowBookmarks property of the View object to false or true.

    Visual Studio erweitert das Bookmark -Objekt durch Bereitstellen des Bookmark -Hoststeuerelements.Visual Studio extends the Bookmark object by providing the Bookmark host control. Das Bookmark -Hoststeuerelement verhält sich wie ein systemeigenes Bookmark-Objekt, stellt jedoch zusätzliche Ereignisse und Datenbindungsfunktionen bereit.The Bookmark host control behaves like a native Bookmark, but has additional events and data-binding capabilities. Sie können Daten an ein Bookmark-Steuerelement für ein Dokument auf die gleiche Weise binden wie Daten an ein Textfeld-Steuerelement für Windows Forms.You can bind data to a bookmark control on a document in the same way that you bind data to a text box control on a Windows Form. Weitere Informationen finden Sie unter Bookmark Control.For more information, see Bookmark control.

Verwenden der Dokumentation zum Word-ObjektmodellUse the Word object model documentation

Ausführliche Informationen zum Word-Objektmodell finden Sie in der Referenz für die primäre Interopassembly (PIA) und der VBA-Objektmodellreferenz (Visual Basic for Applications).For complete information about the Word object model, you can refer to the Word primary interop assembly (PIA) reference and the Visual Basic for Applications (VBA) object model reference.

Referenz zur primären InteropassemblyPrimary interop assembly reference

In der Referenzdokumentation für die Word-PIA werden die Typen in der primären Interopassembly für Word beschrieben.The Word PIA reference documentation describes the types in the primary interop assembly for Word. Diese Dokumentation ist unter folgendem Speicherort verfügbar: Word 2010 primärer interopassemblyverweis.This documentation is available from the following location: Word 2010 primary interop assembly reference.

Weitere Informationen zum Entwurf der Word-Pia, z. b. zu den Unterschieden zwischen Klassen und Schnittstellen in der Pia und zur Implementierung von Ereignissen in der Pia, finden Sie unter Übersicht über Klassen und Schnittstellen in den primären Interop-Assemblys von Office.For more information about the design of the Word PIA, such as the differences between classes and interfaces in the PIA and how events in the PIA are implemented, see Overview of classes and interfaces in the Office primary interop assemblies.

VBA-Objektmodell ReferenzVBA object model reference

Die VBA-Objektmodellreferenz dokumentiert das Word-Objektmodell, das für VBA-Code (Visual Basic for Applications) zur Verfügung gestellt wird.The VBA object model reference documents the Word object model as it is exposed to VBA code. Weitere Informationen finden Sie unter Word 2010-Objektmodell Referenz.For more information, see Word 2010 object model reference.

Alle Objekte und Elemente in der VBA-Objektmodellreferenz entsprechen Typen und Elementen in der Word-PIA.All of the objects and members in the VBA object model reference correspond to types and members in the Word PIA. Das Document-Objekt in der VBA-Objektmodell Referenz entspricht z. b Document . dem-Objekt in der Word-Pia.For example, the Document object in the VBA object model reference corresponds to the Document object in the Word PIA. Obwohl die VBA-Objektmodellreferenz Codebeispiele für die meisten Eigenschaften, Methoden und Ereignisse enthält, müssen Sie den VBA-Code in dieser Referenz in Visual Basic oder Visual C# übersetzen, wenn Sie ihn in einem mit Visual Studio erstellten Word-Projekt verwenden möchten.Although the VBA object model reference provides code examples for most properties, methods, and events, you must translate the VBA code in this reference to Visual Basic or Visual C# if you want to use them in a Word project that you create by using Visual Studio.

Siehe auchSee also