Vue d'ensemble du modèle objet Word

Article
08/10/2011

Lorsque vous développez des solutions Word dans Visual Studio, vous interagissez avec le modèle objet Word. Ce modèle objet se compose de classes et interfaces fournies dans l'assembly PIA (Primary Interop Assembly) pour Word et définies dans l'espace de noms Microsoft.Office.Interop.Word.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Word 2007 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Cette rubrique propose une vue d'ensemble succincte du modèle objet Word. Pour obtenir la liste des ressources fournissant des informations complémentaires sur le modèle objet Word complet, consultez Utilisation de la documentation relative au modèle objet Word.

Pour plus d'informations sur l'utilisation du modèle objet Word pour effectuer des tâches spécifiques, consultez les rubriques suivantes :

Fonctionnement du modèle objet Word

Word fournit des centaines d'objets avec lesquels vous pouvez interagir. Ces objets sont organisés dans une hiérarchie qui suit de près l'interface utilisateur. Au haut de la hiérarchie figure l'objet Application, qui représente l'instance actuelle de Word. L'objet Application contient les objets Document, Selection, Bookmark et Range. Chacun de ces objets possède de nombreuses méthodes et propriétés auxquelles vous pouvez accéder pour le manipuler et interagir avec.

L'illustration suivante montre une vue de ces objets dans la hiérarchie du modèle objet Word.

Extrait du modèle objet Word

Graphique du modèle objet Word

À première vue, il semble y avoir de nombreux chevauchements. Par exemple, les objets Document et Selection sont tous deux membres de l'objet Application, mais l'objet Document est également un membre de l'objet Selection. Les objets Document et Selection contiennent les objets Bookmark et Range. Ce chevauchement s'explique par le fait qu'il existe plusieurs manières d'accéder au même type d'objet. Vous pouvez par exemple appliquer la mise en forme à un objet Range, mais souhaiter accéder à la plage de la sélection actuelle, d'un paragraphe déterminé, d'une section ou du document entier.

Les rubriques suivantes décrivent brièvement les objets de premier niveau et la façon dont ils interagissent les uns avec les autres. Ces objets incluent les cinq éléments suivants :

Objet application
Objet Document
Objet Sélection
Objet Range
Objet Bookmark

En plus du 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. 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 relatives à la liaison de données et des événements supplémentaires. 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.

Objet Application

L'objet Application représente l'application Word et est le parent de l'ensemble des autres objets. Ses membres s'appliquent généralement en bloc à Word. Vous pouvez utiliser ses propriétés et méthodes pour contrôler l'environnement Word.

Dans les projets de complément au niveau de l'application, vous pouvez accéder à l'objet Application à l'aide du champ Application de la classe ThisAddIn. Pour plus d'informations, consultez Programmation de compléments d'application.

Dans les projets au niveau du document, vous pouvez accéder à l'objet Application à l'aide de la propriété Application de la classe ThisDocument.

Objet Document

L'objet Microsoft.Office.Interop.Word.Document est essentiel à la programmation de Word. Il représente un document et l'intégralité de son contenu. Lorsque vous ouvrez ou créez un document, vous créez un objet Microsoft.Office.Interop.Word.Document, qui est ajouté à la collection Documents de l'objet Application. Le document qui a le focus et le document actif. Il est représenté par la propriété ActiveDocument de l'objet Application.

Les outils de développement Office dans Visual Studio étendent l'objet Microsoft.Office.Interop.Word.Document en fournissant le type Microsoft.Office.Tools.Word.Document. Ce type est un élément hôte qui vous donne accès à toutes les fonctionnalités d'un objet Microsoft.Office.Interop.Word.Document et ajoute des événements supplémentaires et la possibilité d'ajouter des contrôles managés.

Lorsque vous créez un projet au niveau du document, vous pouvez accéder aux membres Microsoft.Office.Tools.Word.Document à l'aide de la classe ThisDocument générée dans votre projet. Vous pouvez accéder aux membres de l'élément hôte Microsoft.Office.Tools.Word.Document à l'aide des mots clés Me ou this depuis le code de la classe ThisDocument, ou à l'aide du code Globals.ThisDocument en dehors de la classe ThisDocument. Pour plus d'informations, consultez Programmation de personnalisations au niveau du document. Par exemple, pour sélectionner le premier paragraphe du document, utilisez le code suivant :

Me.Paragraphs(1).Range.Select()

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

Dans les projets au niveau de l'application, vous pouvez générer des éléments hôtes Microsoft.Office.Tools.Word.Document au moment de l'exécution. Vous pouvez utiliser l'élément hôte généré pour ajouter des contrôles et des balises actives au document associé. Pour plus d'informations, consultez Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution..

Notes

Les balises actives sont déconseillées dans Excel 2010 et Word 2010. Pour plus d'informations, consultez Vue d'ensemble des balises actives.

Objet Selection

L'objet Selection représente la zone actuellement sélectionnée. Lorsque vous effectuez une opération dans l'interface utilisateur de Word, comme la mise du texte en gras, vous sélectionnez le texte ou le mettez en surbrillance, puis appliquez la mise en forme. L'objet Selection est toujours présent dans un document. Si rien n'est sélectionné, il représente le point d'insertion. De plus, une sélection peut comprendre plusieurs blocs de texte qui ne sont pas contigus.

Objet Range

L'objet Range représente une zone contiguë dans un document et est défini par une position du caractère de départ et une position du caractère de fin. Vous n'êtes pas limité à un seul objet Range. Vous pouvez définir plusieurs objets Range dans le même document. Un objet Range possède les caractéristiques suivantes :

Il peut consister en un point d'insertion seul, une plage de texte ou la totalité du document.
Il inclut des caractères non imprimables, tels qu'espaces, tabulations et marques de paragraphe.
Il peut correspondre à la zone représentée par la sélection active ou représenter une zone différente de la sélection en cours.
Il n'est pas visible dans un document, contrairement à une sélection, qui l'est toujours.
Il n'est pas enregistré avec un document et n'existe qu'aussi longtemps que le code est exécuté.

Lorsque vous insérez du texte à la fin d'une plage, Word étend automatiquement la plage pour inclure le texte inséré.

Objets de contrôle de contenu

Microsoft.Office.Interop.Word.ContentControl vous permet de contrôler les entrées et la présentation d'un texte ainsi que d'autres types de contenu des documents Word. Un Microsoft.Office.Interop.Word.ContentControl peut afficher plusieurs types d'interface utilisateur différents, optimisés pour les documents Word, comme des contrôles de texte enrichi, un sélecteur de date ou une zone de liste déroulante. Vous pouvez également utiliser un Microsoft.Office.Interop.Word.ContentControl pour empêcher des utilisateurs de modifier des sections du document ou du modèle.

Visual Studio étend l'objet Microsoft.Office.Interop.Word.ContentControl en plusieurs contrôles hôtes différents. Alors que l'objet Microsoft.Office.Interop.Word.ContentControl peut afficher tous les types différents d'interface utilisateur disponibles pour les contrôles de contenu, Visual Studio fournit un type différent pour chaque contrôle de contenu. Par exemple, vous pouvez utiliser un Microsoft.Office.Tools.Word.RichTextContentControl pour créer un contrôle de texte enrichi ou un Microsoft.Office.Tools.Word.DatePickerContentControl pour créer un sélecteur de dates. Ces contrôles hôtes se comportent de la même manière que le Microsoft.Office.Interop.Word.ContentControl natif, mais possèdent des événements supplémentaires et des fonctionnalités de liaison de données. Pour plus d'informations, consultez Contrôles de contenu.

Objet Bookmark

L'objet Microsoft.Office.Interop.Word.Bookmark représente une zone contiguë dans un document, avec une position de départ et une position de fin. Les signets servent à marquer un emplacement dans un document ou comme conteneur de texte dans un document. Un objet Microsoft.Office.Interop.Word.Bookmark peut être constitué du point d'insertion ou contenir l'intégralité du document. Un Microsoft.Office.Interop.Word.Bookmark possède les caractéristiques suivantes qui le différencient de l'objet Range :

Vous pouvez nommer le signet au moment du design.
Les objets Microsoft.Office.Interop.Word.Bookmark 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.
Les signets peuvent être masqués ou rendus visibles en attribuant à la propriété ShowBookmarks de l'objet View la valeur false ou true.

Visual Studio étend l'objet Microsoft.Office.Interop.Word.Bookmark en fournissant le contrôle hôte Microsoft.Office.Tools.Word.Bookmark. Le contrôle hôte Microsoft.Office.Tools.Word.Bookmark se comporte comme un Microsoft.Office.Interop.Word.Bookmark natif, mais possède des événements et des fonctionnalités de liaison de données supplémentaires. 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. Pour plus d'informations, consultez Bookmark, contrôle.

Utilisation de la documentation relative au modèle objet Word

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 Word et à la documentation de référence du modèle objet VBA.

Référence d'assembly PIA (Primary Interop Assembly)

La documentation de référence de l'assembly PIA Word décrit les types de l'assembly PIA pour Word. Cette documentation est disponible à l'emplacement suivant : Documentation de référence de l'assembly PIA (Primary Interop Assembly) Word 2010 (page éventuellement en anglais).

Notes

L'assembly PIA Word 2007 ne possède pas encore de documentation de référence. Toutefois, les types de l'assembly PIA Word 2007 sont également compris dans l'assembly PIA Word 2010, par conséquent, les informations de cette documentation de référence s'appliquent également à Word 2007.

Pour plus d'informations sur la création d'un assembly PIA Word, telles que les différences entre les classes et entre les interfaces de l'assembly PIA et l'implémentation des événements dans l'assembly PIA, consultez Vue d'ensemble des classes et interfaces des assemblys PIA (Primary Interop Assembly) Office (page éventuellement en anglais).

Documentation de référence du modèle objet VBA

La documentation de référence du modèle objet VBA contient des informations sur le modèle objet Word, tel qu'exposé au code VBA. La documentation de référence du modèle objet VBA pour Word peut être consultée aux emplacements suivants :

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. Par exemple, l'objet Document dans la documentation de référence du modèle objet VBA correspond à l'objet Microsoft.Office.Interop.Word.Document dans l'assembly PIA Word. 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 devrez traduire le code VBA en Visual Basic ou Visual C#, si vous souhaitez les utiliser dans un projet Word créé à l'aide de Visual Studio.