Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

Vue d'ensemble du modèle objet Word

 

Quand 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 d'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 aux projets de compléments VSTO pour Word. Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Cette rubrique propose une brève présentation 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 du modèle objet Word.

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

Word fournit des centaines d'objets avec lesquels vous pouvez interagir. Ces objets sont organisés selon une hiérarchie qui suit étroitement l'interface utilisateur. L'objet Application se trouve en haut de la hiérarchie. Cet objet représente l'instance active 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 manipuler l'objet et interagir avec lui.

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

Graphique du modèle objet Word

Résumé du modèle objet Word

À première vue, les objets semblent se chevaucher. 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. Les objets Document et Selection contiennent tous les deux les objets Bookmark et Range. Ce chevauchement existe parce qu'il existe plusieurs manières d'accéder au même type d'objet. 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.

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. Ces objets incluent les cinq éléments suivants :

  • Objet Application

  • Objet Document

  • Objet Selection

  • Range (objet)

  • Objet Bookmark

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. 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. 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.

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

Dans les projets de compléments VSTO, 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 VSTO.

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

L'objet Microsoft.Office.Interop.Word.Document est essentiel à la programmation de Word. Il représente un document et tout son contenu. Quand vous ouvrez ou créez un document, vous créez un objet Microsoft.Office.Interop.Word.Document, qui est ajouté à la collection T:Microsoft.Office.Interop.Word.Documents de l'objet Application. Le document qui a le focus est appelé document actif. Il est représenté par la propriété P:Microsoft.Office.Interop.Word._Application.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.

Quand vous créez un projet au niveau du document, vous pouvez accéder aux membres Microsoft.Office.Tools.Word.Document en utilisant 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 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. 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 :

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

Dans les projets de compléments VSTO, 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 au document associé. Pour plus d'informations, consultez Extension de documents Word et de classeurs Excel dans des compléments VSTO au moment de l'exécution.

L'objet Selection représente la zone actuellement sélectionnée. 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. L'objet Selection est toujours présent dans un document. Si rien n'est sélectionné, il représente le point d'insertion. En outre, une sélection peut comprendre plusieurs blocs de texte non contigus.

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. Vous n'êtes pas limité à un seul objet Range. Vous pouvez définir plusieurs objets Range dans un même document. Un objet Range a les caractéristiques suivantes :

  • Il peut être constitué du point d'insertion seul, d'une plage de texte ou de l'intégralité du document.

  • Il inclut des caractères non imprimables tels que des espaces, des tabulations et des marques de paragraphe.

  • 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.

  • Il n'est pas visible dans un document, contrairement à une sélection, qui est toujours visible.

  • Il n'est pas enregistré avec un document et il existe uniquement pendant l'exécution du code.

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

Un objet Microsoft.Office.Interop.Word.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. Un objet Microsoft.Office.Interop.Word.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. Vous pouvez également utiliser Microsoft.Office.Interop.Word.ContentControl pour empêcher les 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 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 objet Microsoft.Office.Tools.Word.RichTextContentControl pour créer un contrôle de texte enrichi ou un objet Microsoft.Office.Tools.Word.DatePickerContentControl pour créer un sélecteur de date. Ces contrôles hôtes se comportent comme l'objet Microsoft.Office.Interop.Word.ContentControl natif, mais ils possèdent des fonctionnalités de liaison de données et des événements supplémentaires. Pour plus d'informations, consultez Contrôles de contenu.

L'objet Microsoft.Office.Interop.Word.Bookmark représente une zone contiguë dans un document, avec une position de début et une position de fin. Vous pouvez utiliser des signets pour 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 s'étendre à l'intégralité du document. Un objet Microsoft.Office.Interop.Word.Bookmark présente les caractéristiques suivantes, qui le différencient de l'objet Range :

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 objet Microsoft.Office.Interop.Word.Bookmark natif, mais il possède des fonctionnalités de liaison de données et des événements 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.

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).

La documentation de référence de l'assembly PIA Word décrit les types figurant dans 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.

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 l’implémentation des événements dans l’assembly PIA, consultez Vue d’ensemble des classes et des interfaces dans les assemblys PIA (Primary Interop Assembly) Office.

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. Pour plus d’informations, consultez Référence du modèle objet Word 2010.

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 mentionné 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 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.

Afficher: