Élément hôte de document

L’élément Document hôte est un type qui étend le type Document de l’assemblage d’interopérabilité principal pour Word. L’élément Document hôte fournit toutes les mêmes propriétés, méthodes et événements en tant qu’objet Document , mais il expose également des événements supplémentaires et agit comme conteneur pour les contrôles hôtes et les contrôles Windows Forms.

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.

Dans les projets au niveau du document, il existe un élément hôte par défaut Document qui représente le document dans votre projet. Dans les projets de complément VSTO, vous pouvez générer Document des éléments hôtes au moment de l’exécution.

Comprendre l'élément hôte de document dans les projets de niveau document

Pour accéder au document dans votre projet, utilisez la ThisDocument classe. Lorsque vous créez un projet au niveau du document, Visual Studio génère la ThisDocument classe pour servir de lien de communication entre Word et votre code de personnalisation. La ThisDocument classe vous donne accès aux membres de l’élément Document hôte pour effectuer des tâches de base dans votre personnalisation, telles que l’exécution du code lorsque le document est ouvert ou fermé. Vous pouvez également utiliser la classe pour ajouter des contrôles au document. En combinant différents ensembles de contrôles et d’écriture de code, vous pouvez lier les contrôles aux données, collecter des informations de l’utilisateur et répondre aux actions de l’utilisateur. Pour plus d’informations, consultez Les personnalisations au niveau du document du programme.

La ThisDocument classe fournit un emplacement dans lequel vous pouvez commencer à écrire du code dans votre projet. Étant donné que la classe fournit toutes les mêmes propriétés, méthodes et événements que l’objet Document dans l’assembly d’interopérabilité principal pour Word, vous pouvez également utiliser ThisDocument pour accéder au modèle objet de Word. Pour plus d’informations, consultez la vue d’ensemble du modèle objet Word.

Limitations de l’élément hôte de document dans les projets au niveau du document

Un projet au niveau du document ne peut contenir qu’un seul Document élément hôte (autrement dit, la ThisDocument classe). Vous ne pouvez pas ajouter de nouveaux Document éléments hôtes à votre projet au moment du design, et vous ne pouvez pas créer de nouveaux Document éléments hôtes au moment de l’exécution à partir d’une personnalisation au niveau du document.

Si vous créez un document Word au moment de l’exécution, il sera de type Document. Étant donné qu’il n’est pas un élément hôte, il ne peut pas contenir de contrôles hôtes ou de contrôles Windows Forms. Pour plus d’informations sur la création de documents au moment de l’exécution, consultez Guide pratique pour créer des documents par programmation.

Comprendre les éléments hôtes de document dans les projets au niveau de l’application

Dans les projets de complément VSTO, vous pouvez générer un Document élément hôte au moment de l’exécution pour tout document ouvert dans Word. Vous pouvez utiliser l’élément Document hôte pour ajouter des contrôles au document associé ou pour gérer les événements qui ne sont pas disponibles sur Document les objets.

Pour générer un Document élément hôte, utilisez la GetVstoObject méthode. Pour plus d’informations, consultez Étendre les documents Word et les classeurs Excel dans les compléments VSTO au moment de l’exécution.

Contenu connexe

• Vue d’ensemble des éléments hôtes et des contrôles hôtes
• Automatiser Word à l’aide d’objets étendus
• Vue d’ensemble du modèle objet Word
• Limitations programmatiques des éléments hôtes et des contrôles hôtes
• Étendre les documents Word et les classeurs Excel dans les compléments VSTO pendant l'exécution