Élément hôte de document
L'élément hôte Document est un type qui étend le type Microsoft.Office.Interop.Word.Document de l'assembly PIA pour Word. L'élément hôte Document fournit les mêmes propriétés, méthodes et événements qu'un objet Microsoft.Office.Interop.Word.Document, mais expose en plus des événements supplémentaires et joue le rôle de conteneur pour les contrôles hôtes et Windows Forms.
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.
Dans les projets au niveau du document, il existe un élément hôte Document par défaut qui représente le document de votre projet. Dans les projets au niveau de l'application, vous pouvez générer des éléments hôtes Document au moment de l'exécution.
Fonctionnement de l'élément hôte de document dans des projets au niveau du document
Pour accéder au document de votre projet, utilisez la classe ThisDocument. Lorsque vous créez un projet au niveau du document, Visual Studio génère la classe ThisDocument pour qu'elle serve de liaison entre Word et le code de votre personnalisation. La classe ThisDocument vous donne accès aux membres de l'élément hôte Document pour effectuer des tâches de base dans votre personnalisation, telle que l'exécution du code lorsque le document est ouvert ou fermé. Vous pouvez également utiliser la classe pour ajouter des contrôles et des balises actives au document. En combinant plusieurs jeux de contrôles et en écrivant du code, vous pouvez lier les contrôles aux données, rassembler des informations auprès de l'utilisateur et répondre aux actions de celui-ci. Pour plus d'informations, consultez Programmation de personnalisations au niveau du document.
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.
La classe ThisDocument fournit un emplacement dans lequel vous pouvez commencer à écrire du code dans votre projet. Étant donné que la classe fournit les mêmes propriétés, méthodes et événements qu'un objet Microsoft.Office.Interop.Word.Document dans l'assembly PIA pour Word, vous pouvez également utiliser ThisDocument pour accéder au modèle objet de Word. Pour plus d'informations, consultez 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 peut contenir un seul élément hôte Document (c'est-à-dire la classe ThisDocument). Vous ne pouvez pas ajouter de nouveaux éléments hôtes Document à votre projet au moment du design et ne pouvez pas non plus créer d'éléments hôtes Document au moment de l'exécution à partir d'une personnalisation au niveau du document.
Si vous créez un nouveau document Word au moment de l'exécution, celui-ci sera du type Microsoft.Office.Interop.Word.Document. Comme il ne s'agit pas d'un élément hôte, il ne peut contenir aucun contrôle hôte ni aucun contrôle Windows Forms. Pour plus d'informations sur la création de documents au moment de l'exécution, consultez Comment : créer de nouveaux documents.
Fonctionnement des éléments hôtes de document dans des projets au niveau de l'application
Dans les projets au niveau de l'application, vous pouvez générer un élément hôte Document au moment de l'exécution pour tout document ouvert dans Word. Vous pouvez utiliser l'élément hôte Document pour ajouter des contrôles et des balises actives au document associé ou gérer des événements qui ne sont pas disponibles sur les objets Microsoft.Office.Interop.Word.Document.
Pour générer un élément hôte Document, utilisez la méthode GetVstoObject. 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..
Voir aussi
Concepts
Vue d'ensemble des éléments hôtes et des contrôles hôtes
Automatisation de Word à l'aide d'objets étendus
Limitations de programmation des éléments hôtes et des contrôles hôtes