Partager via

Vue d’ensemble du modèle objet Word

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 d’interfaces fournies dans l’assembly d’interopérabilité principal pour Word et définies dans l’espace Microsoft.Office.Interop.Word de noms.

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 type d’application et de projet Office.

Cette rubrique fournit une brève vue d’ensemble 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 plus d’informations sur l’utilisation du modèle objet Word pour effectuer des tâches spécifiques, consultez les rubriques suivantes :

Comprendre le 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 étroitement l’interface utilisateur. En haut de la hiérarchie, il s’agit de l’objet Application . Cet objet représente l’instance actuelle de Word. L'objet Application contient les objets Document, Selection, Bookmark et Range. Chacun de ces objets a de nombreuses méthodes et propriétés auxquelles vous pouvez accéder pour manipuler et interagir avec l’objet.

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

Graphique du modèle d'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 des objets Bookmark et Range. Le chevauchement existe, car il existe plusieurs façons d’accéder au même type d’objet. Par exemple, vous appliquez une mise en forme à un Range objet ; mais vous souhaiterez peut-être accéder à la plage de la sélection actuelle, d’un paragraphe particulier, d’une section ou de l’ensemble du document.

Les sections suivantes décrivent brièvement les objets de niveau supérieur et comment ils interagissent entre eux. Ces objets incluent les cinq suivants :

  • Objet Application

  • Document, objet

  • Objet de sélection

  • Objet Range

  • 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 dans le 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 ont également des fonctionnalités supplémentaires telles que des fonctionnalités de 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ément VSTO, vous pouvez accéder à l'objet Application par le champ Application de la classe ThisAddIn. Pour plus d’informations, consultez Programmer des compléments VSTO.

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

Document, objet

L’objet Document est essentiel à la programmation de Word. Il représente un document et tout son contenu. Lorsque vous ouvrez un document ou créez un document, vous créez un Document objet qui est ajouté à la Documents collection de l’objet Application . Le document qui a le focus est appelé document actif. Elle est représentée par la ActiveDocument propriété de l’objet Application .

Les outils de développement Office dans Visual Studio étendent l’objet Document en fournissant le Document type. Ce type est un élément hôte qui vous donne accès à toutes les fonctionnalités d’un Document objet, 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 Document membres à l’aide de la classe générée ThisDocument dans votre projet. Vous pouvez accéder aux membres de l’élément Document hôte à l’aide des mots clés Me ou this à partir du code de la classe ThisDocument, ou avec Globals.ThisDocument depuis le code 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.

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

Dans les projets de complément VSTO, vous pouvez générer Document des éléments hôtes 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 de sélection

L’objet Selection représente la zone actuellement sélectionnée. Lorsque vous effectuez une opération dans l’interface utilisateur de Word, telle que le 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 englober 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 de caractère de départ et une position de caractère de fin. Vous n’êtes pas limité à un seul Range objet. Vous pouvez définir plusieurs Range objets dans le même document. Un Range objet présente les caractéristiques suivantes :

  • Il peut se composer du point d’insertion seul, d’une plage de texte ou de l’ensemble du document.

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

  • Il peut s’agir de la zone représentée par la sélection actuelle ou d’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 existe uniquement pendant l’exécution du code.

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

Objets de contrôle de contenu

Une méthode avec ContentControl pour contrôler l’entrée et la présentation de texte et d’autres types de contenu dans un document Word. Un ContentControl peut afficher plusieurs types d’interface utilisateur optimisés pour une utilisation dans les documents Word, tels qu’un contrôle de texte enrichi, un sélecteur de dates ou une zone de liste déroulante. Vous pouvez également utiliser une ContentControl option pour empêcher les utilisateurs de modifier des sections du document ou du modèle.

Visual Studio étend l’objet ContentControl dans plusieurs contrôles hôtes différents. Alors que l’objet ContentControl peut afficher l’un des différents 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 RichTextContentControl pour créer un contrôle de texte enrichi, ou vous pouvez utiliser un DatePickerContentControl pour créer un sélecteur de dates. Ces contrôles hôtes se comportent comme le natif ContentControl, mais ils ont des événements et des fonctionnalités de liaison de données 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épart 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 Bookmark objet peut se composer du point d’insertion ou être aussi volumineux que l’ensemble du document. A Bookmark présente les caractéristiques suivantes qui la distinguent de l’objet Range :

  • Vous pouvez nommer le signet lors de la conception.

  • Bookmark les objets sont enregistrés avec le document et ne sont donc pas supprimés lorsque le code cesse de s’exécuter ou que votre document est fermé.

  • Les favoris peuvent être masqués ou affichés en définissant la propriété de l’objet View sur faux ou vrai.

    Visual Studio étend l’objet Bookmark en fournissant le Bookmark contrôle hôte. Le Bookmark contrôle hôte se comporte comme un contrôle natif Bookmark, mais a 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 sur un document de la même façon que vous liez des données à un contrôle de zone de texte sur 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 consulter la référence de l'assembly d'interopérabilité principal (PIA) de Word et la référence du modèle objet de Visual Basic pour Applications (VBA).

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

La documentation de référence du PIA Word décrit les types dans l'assembly d'interopérabilité primaire pour Word. Cette documentation est disponible à partir de l’emplacement suivant : référence principale d’interopérabilité 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 Office.

Référence du modèle objet VBA

La documentation de référence du modèle objet VBA décrit 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 de la référence du modèle objet VBA correspondent aux types et aux membres de l’assembly PIA de 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. Bien que la 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 dans cette référence à Visual Basic ou Visual C# si vous souhaitez les utiliser dans un projet Word que vous créez à l’aide de Visual Studio.

Contenu connexe

  • Last updated on