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 au niveau du document et aux projets de complément VSTO pour Word. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

Cette rubrique propose une brève présentation du modèle objet Word. Pour plus d’informations sur l’ensemble du modèle objet Word, consultez la documentation relative au 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 :

• Utiliser des documents

• Utiliser du texte dans des documents

• Utiliser des tables

Comprendre le modèle objet Word

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

À 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 comment ils interagissent entre eux. 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 Automatiser Word à l’aide d’objets étendus et d’éléments hôtes et d’une vue d’ensemble des contrôles hôtes.

Objet application

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 Les compléments VSTO program.

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

Objet Document

L'objet 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 Document , qui est ajouté à la collection Documents de l'objet Application . Le document qui a le focus est appelé 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 Document en fournissant le type Document . 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.

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. 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 . Pour plus d’informations, consultez Les personnalisations au niveau du document du programme. Par exemple, pour sélectionner le premier paragraphe du document, utilisez le code suivant :

C#

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

VB

Me.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. Vous pouvez utiliser l'élément hôte généré pour ajouter des contrôles au document associé. Pour plus d’informations, consultez Étendre les documents Word et les classeurs Excel dans les compléments VSTO au moment de l’exécution.

Objet Selection

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.

Range (objet)

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

Objets de contrôle de contenu

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. 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. Vous pouvez également utiliser ContentControl pour empêcher les utilisateurs de modifier des sections du document ou du modèle.

Visual Studio étend l'objet ContentControl en plusieurs contrôles hôtes différents. 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. 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. 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. Pour plus d’informations, consultez Contrôles de contenu.

Objet Bookmark

L'objet 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 Bookmark peut être constitué du point d'insertion ou s'étendre à l'intégralité du document. Un objet Bookmark présente les caractéristiques suivantes, qui le différencient de l'objet Range :

• Vous pouvez nommer le signet au moment du design.

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

• Vous pouvez masquer ou afficher les signets en attribuant à la propriété ShowBookmarks de la classe View la valeur false ou true.

  Visual Studio étend l'objet Bookmark en fournissant le contrôle hôte Bookmark . 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. 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 le contrôle Signet.

Utiliser la documentation du 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 (Primary Interop Assembly) Word et à la documentation de référence du modèle objet VBA (Visual Basic pour Applications).

Informations de référence sur l’assembly d’interopérabilité principale

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 à partir de l’emplacement suivant : référence d’assembly d’interopérabilité principale 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 la façon dont les événements dans l’assembly PIA sont implémentés, consultez Vue d’ensemble des classes et des interfaces dans les assemblys d’interopérabilité principaux Bureau.

Référence du modèle objet VBA

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 la 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 dans la référence du modèle objet VBA correspond à l’objet 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.

Contenu connexe

• Bureau assemblys d’interopérabilité principaux
• Automatiser Word à l’aide d’objets étendus
• Utiliser des documents
• Utiliser du texte dans des documents
• Utiliser des tables
• Vue d’ensemble des éléments hôtes et des contrôles hôtes
• Limitations programmatiques des éléments hôtes et des contrôles hôtes
• Paramètres facultatifs dans les solutions Bureau