Vue d’ensemble du modèle objet WordWord object model overview

Quand vous développez des solutions Word dans Visual Studio, vous interagissez avec le modèle objet Word.When you develop Word solutions in Visual Studio, you interact with the Word object model. Ce modèle objet se compose de classes et d'interfaces fournies dans l'assembly PIA (Primary Interop Assembly) pour Word et définies dans l'espace de noms Microsoft.Office.Interop.Word .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.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux - projets de niveau document et aux projets de compléments VSTO - pour Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. Pour plus d’informations, consultez fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features available by Office application and project type.

Cette rubrique propose une brève présentation du modèle objet Word.This topic provides a brief overview of the Word object model. Pour obtenir des ressources qui vous permettent d’en savoir plus sur l’ensemble du modèle objet Word, consultez utiliser la documentation du modèle objet Word.For resources where you can learn more about the entire Word object model, see Use the Word object model documentation.

Pour obtenir des informations sur l'utilisation du modèle objet Word pour effectuer des tâches spécifiques, consultez les rubriques suivantes :For information about using the Word object model to perform specific tasks, see the following topics:

Comprendre le modèle objet WordUnderstand the Word object model

Word fournit des centaines d'objets avec lesquels vous pouvez interagir.Word provides hundreds of objects with which you can interact. Ces objets sont organisés selon une hiérarchie qui suit étroitement l'interface utilisateur.These objects are organized in a hierarchy that closely follows the user interface. L'objet Application se trouve en haut de la hiérarchie.At the top of the hierarchy is the Application object. Cet objet représente l'instance active de Word.This object represents the current instance of Word. L'objet Application contient les objets Document, Selection, Bookmarket Range .The Application object contains the Document, Selection, Bookmark, and Range objects. Chacun de ces objets possède de nombreuses méthodes et propriétés auxquelles vous pouvez accéder pour manipuler l'objet et interagir avec lui.Each of these objects has many methods and properties that you can access to manipulate and interact with the object.

L'illustration suivante montre une vue de ces objets dans la hiérarchie du modèle objet Word.The following illustration shows one view of these objects in the hierarchy of the Word object model.

Graphique du modèle objet WordWord Object Model graphic

À première vue, les objets semblent se chevaucher.At first glance, objects appear to overlap. Par exemple, les objets Document et Selection sont tous deux membres de l'objet Application , mais l'objet Document est également membre de l'objet Selection .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. Les objets Document et Selection contiennent tous les deux les objets Bookmark et Range .Both the Document and Selection objects contain Bookmark and Range objects. Ce chevauchement existe parce qu'il existe plusieurs manières d'accéder au même type d'objet.The overlap exists because there are multiple ways you can access the same type of object. Vous pouvez par exemple appliquer une mise en forme à un objet Range , mais souhaiter accéder à la plage de la sélection actuelle, d'un paragraphe particulier, d'une section ou du document entier.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.

Les sections suivantes décrivent brièvement les objets de niveau supérieur et la façon dont ils interagissent les uns avec les autres.The following sections briefly describe the top-level objects and how they interact with each other. Ces objets incluent les cinq éléments suivants :These objects include the following five:

  • Objet applicationApplication object

  • Objet DocumentDocument object

  • Objet SelectionSelection object

  • Range (objet)Range object

  • Objet BookmarkBookmark object

    Outre le modèle objet Word, les projets Office dans Visual Studio fournissent des éléments hôtes et des contrôles hôtes qui étendent certains objets du modèle objet Word.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. Les éléments hôtes et les contrôles hôtes se comportent comme les objets Word qu'ils étendent, mais ils possèdent également des fonctionnalités supplémentaires, telles que la liaison de données, et des événements supplémentaires.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. Pour plus d’informations, consultez automatisation de Word à l’aide d’objets étendus et vue d’ensemble des éléments hôtes et des contrôles hôtes.For more information, see Automate Word by using extended objects and Host items and host controls overview.

Objet applicationApplication object

L'objet Application représente l'application Word et est le parent de tous les autres objets.The Application object represents the Word application, and is the parent of all of the other objects. Ses membres s'appliquent généralement à Word dans son ensemble.Its members usually apply to Word as a whole. Vous pouvez utiliser ses propriétés et méthodes pour contrôler l'environnement Word.You can use its properties and methods to control the Word environment.

Dans les projets de compléments VSTO, vous pouvez accéder à l'objet Application à l'aide du champ Application de la classe ThisAddIn .In VSTO Add-in projects, you can access the Application object by using the Application field of the ThisAddIn class. Pour plus d’informations, consultez compléments VSTO du programme.For more information, see Program VSTO Add-ins.

Dans les projets au niveau du document, vous pouvez accéder à l'objet Application en utilisant la propriété Application de la classe ThisDocument .In document-level projects, you can access the Application object by using the Application property of the ThisDocument class.

Objet DocumentDocument object

L'objet Document est essentiel à la programmation de Word.The Document object is central to programming Word. Il représente un document et tout son contenu.It represents a document and all of its contents. Quand vous ouvrez ou créez un document, vous créez un objet Document , qui est ajouté à la collection Documents de l'objet Application .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. Le document qui a le focus est appelé document actif.The document that has the focus is called the active document. Il est représenté par la propriété ActiveDocument de l'objet Application .It is represented by the ActiveDocument property of the Application object.

Les outils de développement Office dans Visual Studio étendent l'objet Document en fournissant le type Document .The Office development tools in Visual Studio extend the Document object by providing the Document type. Ce type est un élément hôte qui vous donne accès à toutes les fonctionnalités d'un objet Document et ajoute des événements supplémentaires et la possibilité d'ajouter des contrôles managés.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.

Quand vous créez un projet au niveau du document, vous pouvez accéder aux membres Document en utilisant la classe ThisDocument générée dans votre projet.When you create a document-level project, you can access Document members by using the generated ThisDocument class in your project. Vous pouvez accéder aux membres de l'élément hôte Document en utilisant les mots clés Me ou this à partir du code dans la classe ThisDocument ou en utilisant Globals.ThisDocument à partir du code situé en dehors de la classe ThisDocument .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. Pour plus d’informations, consultez programmes personnalisations au niveau du document.For more information, see Program document-level customizations. Par exemple, pour sélectionner le premier paragraphe du document, utilisez le code suivant :For example, to select the first paragraph in the document, use the following code.

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

Dans les projets de compléments VSTO, vous pouvez générer des éléments hôtes Document au moment de l'exécution.In VSTO Add-in projects, you can generate Document host items at run time. Vous pouvez utiliser l'élément hôte généré pour ajouter des contrôles au document associé.You can use the generated host item to add controls to the associated document. Pour plus d’informations, consultez extension de documents Word et de classeurs Excel dans des compléments VSTO au momentde l’exécution.For more information, see Extend Word documents and Excel workbooks in VSTO Add-ins at run time.

Objet SelectionSelection object

L'objet Selection représente la zone actuellement sélectionnée.The Selection object represents the area that is currently selected. Quand vous effectuez une opération dans l'interface utilisateur de Word, comme mettre du texte en gras, vous sélectionnez ou mettez en surbrillance le texte puis appliquez la mise en forme.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. L'objet Selection est toujours présent dans un document.The Selection object is always present in a document. Si rien n'est sélectionné, il représente le point d'insertion.If nothing is selected, then it represents the insertion point. En outre, une sélection peut comprendre plusieurs blocs de texte non contigus.In addition, a selection can encompass multiple blocks of text that are not contiguous.

Range (objet)Range object

L'objet Range représente une zone contiguë dans un document et il est défini par une position de caractère de début et une position de caractère de fin.The Range object represents a contiguous area in a document, and is defined by a starting character position and an ending character position. Vous n'êtes pas limité à un seul objet Range .You are not limited to a single Range object. Vous pouvez définir plusieurs objets Range dans un même document.You can define multiple Range objects in the same document. Un objet Range a les caractéristiques suivantes :A Range object has the following characteristics:

  • Il peut être constitué du point d'insertion seul, d'une plage de texte ou de l'intégralité du document.It can consist of the insertion point alone, a range of text, or the entire document.

  • Il inclut des caractères non imprimables tels que des espaces, des tabulations et des marques de paragraphe.It includes non-printing characters such as spaces, tab characters, and paragraph marks.

  • Il peut correspondre à la zone représentée par la sélection actuelle ou il peut représenter une zone différente de la sélection actuelle.It can be the area represented by the current selection, or it can represent an area different from the current selection.

  • Il n'est pas visible dans un document, contrairement à une sélection, qui est toujours visible.It is not visible in a document, unlike a selection, which is always visible.

  • Il n'est pas enregistré avec un document et il existe uniquement pendant l'exécution du code.It is not saved with a document and exists only while the code is running.

    Quand vous insérez du texte à la fin d'une plage, Word étend automatiquement la plage pour inclure le texte inséré.When you insert text at the end of a range, Word automatically expands the range to include the inserted text.

Objets de contrôle de contenuContent control objects

Un objet ContentControl vous permet de contrôler l'entrée et la présentation de texte et d'autres types de contenu dans les documents Word.A ContentControl provides a way for you to control the input and presentation of text and other types of content in Word documents. Un objet ContentControl peut afficher différents types d'interface utilisateur optimisés pour être utilisés dans des documents Word, comme un contrôle de texte enrichi, un sélecteur de date ou une zone de liste modifiable.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. Vous pouvez également utiliser ContentControl pour empêcher les utilisateurs de modifier des sections du document ou du modèle.You can also use a ContentControl to prevent users from editing sections of the document or template.

Visual Studio étend l'objet ContentControl en plusieurs contrôles hôtes différents.Visual Studio extends the ContentControl object into several different host controls. Alors que l'objet ContentControl peut afficher tous les types d'interface utilisateur disponibles pour les contrôles de contenu, Visual Studio fournit un type différent pour chaque contrôle de contenu.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. Par exemple, vous pouvez utiliser un objet RichTextContentControl pour créer un contrôle de texte enrichi ou un objet DatePickerContentControl pour créer un sélecteur de date.For example, you can use a RichTextContentControl to create a rich text control, or you can use a DatePickerContentControl to create a date picker. Ces contrôles hôtes se comportent comme l'objet ContentControlnatif, mais ils possèdent des fonctionnalités de liaison de données et des événements supplémentaires.These host controls behave like the native ContentControl, but they have additional events and data-binding capabilities. Pour plus d’informations, consultez contrôles de contenu.For more information, see Content controls.

Objet BookmarkBookmark object

L'objet Bookmark représente une zone contiguë dans un document, avec une position de début et une position de fin.The Bookmark object represents a contiguous area in a document, with both a starting position and an ending position. Vous pouvez utiliser des signets pour marquer un emplacement dans un document ou comme conteneur de texte dans un document.You can use bookmarks to mark a location in a document, or as a container for text in a document. Un objet Bookmark peut être constitué du point d'insertion ou s'étendre à l'intégralité du document.A Bookmark object can consist of the insertion point, or be as large as the entire document. Un objet Bookmark présente les caractéristiques suivantes, qui le différencient de l'objet Range :A Bookmark has the following characteristics that set it apart from the Range object:

  • Vous pouvez nommer le signet au moment du design.You can name the bookmark at design time.

  • Les objetsBookmark sont enregistrés avec le document et ne sont donc pas supprimés à la fin de l'exécution du code ou à la fermeture du document.Bookmark objects are saved with the document, and thus are not deleted when the code stops running or your document is closed.

  • Vous pouvez masquer ou afficher les signets en attribuant à la propriété ShowBookmarks de la classe View la valeur false ou true.Bookmarks can be hidden or made visible by setting the ShowBookmarks property of the View object to false or true.

    Visual Studio étend l'objet Bookmark en fournissant le contrôle hôte Bookmark .Visual Studio extends the Bookmark object by providing the Bookmark host control. Le contrôle hôte Bookmark se comporte comme un objet Bookmarknatif, mais il possède des fonctionnalités de liaison de données et des événements supplémentaires.The Bookmark host control behaves like a native Bookmark, but has additional events and data-binding capabilities. Vous pouvez lier des données à un contrôle de signet dans un document de la même façon que vous liez des données à un contrôle de zone de texte dans un Windows Form.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. Pour plus d’informations, consultez contrôle Bookmark.For more information, see Bookmark control.

Utiliser la documentation du modèle objet WordUse the Word object model documentation

Pour obtenir des informations complètes sur le modèle objet Word, vous pouvez vous reporter à la documentation de référence de l'assembly PIA (Primary Interop Assembly) Word et à la documentation de référence du modèle objet VBA (Visual Basic pour 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.

Référence d’assembly PIA (Primary Interop Assembly)Primary interop assembly reference

La documentation de référence de l'assembly PIA Word décrit les types figurant dans l'assembly PIA pour Word.The Word PIA reference documentation describes the types in the primary interop assembly for Word. Cette documentation est disponible à partir de l’emplacement suivant : référence de l' assembly PIA Word 2010.This documentation is available from the following location: Word 2010 primary interop assembly reference.

Pour plus d’informations sur la conception de l’assembly PIA Word, telles que les différences entre les classes et les interfaces dans l’assembly PIA et le mode d’implémentation des événements dans l’ASSEMBLy Pia, consultez vue d’ensemble des classes et interfaces dans les assemblys PIA (Primary Interop Assembly) d’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.

Référence du modèle objet VBAVBA object model reference

La documentation de référence du modèle objet VBA présente le modèle objet Word tel qu'il est exposé au code VBA.The VBA object model reference documents the Word object model as it is exposed to VBA code. Pour plus d’informations, consultez Référence du modèle objet Word 2010.For more information, see Word 2010 object model reference.

Tous les objets et membres mentionnés dans la documentation de référence du modèle objet VBA correspondent aux types et aux membres de l'assembly PIA Word.All of the objects and members in the VBA object model reference correspond to types and members in the Word PIA. Par exemple, l’objet document dans la documentation de référence du modèle objet VBA correspond à l' Document objet dans l’assembly PIA Word.For example, the Document object in the VBA object model reference corresponds to the Document object in the Word PIA. Même si la documentation de référence du modèle objet VBA fournit des exemples de code pour la plupart des propriétés, méthodes et événements, vous devez traduire le code VBA fourni dans cette documentation de référence en code Visual Basic ou Visual C# pour pouvoir les utiliser dans un projet Word créé à l'aide de Visual Studio.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.

Voir aussiSee also