Élément hôte de document
Mise à jour : Juillet 2008
S'applique à |
|---|
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Projets au niveau du document
Projets au niveau de l'application
Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet. |
L'élément hôte Document représente un document Word qui expose des événements et agit en tant que conteneur pour les contrôles hôtes et les contrôles Windows Forms. L'élément hôte Document fournit également les mêmes propriétés, méthodes et événements que la classe Microsoft.Office.Interop.Word.Document dans l'assembly PIA (Primary Interop Assembly) pour Word.
Dans les projets au niveau du document, il existe un élément hôte Document qui représente le document dans votre projet. À partir de Visual Studio 2008 Service Pack 1 (SP1), vous pouvez également générer des éléments hôtes Document au moment de l'exécution en utilisant des compléments d'application pour Word 2007.
Fonctionnement de l'élément hôte de document dans des projets au niveau du document
Pour accéder par programme au document dans votre projet, utilisez la classe ThisDocument. Lorsque vous créez un projet au niveau du document, Visual Studio Tools pour Office génère la classe ThisDocument pour servir de liaison de communication entre Word et votre code de personnalisation. La classe ThisDocument dérive de la classe d'élément hôte Document. Visual Studio Tools pour Office instancie automatiquement la classe ThisDocument pour vous lorsque le document est ouvert au moment de l'exécution. Vous ne devez pas essayer d'instancier la classe Document directement dans votre code.
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.
La classe ThisDocument fournit un emplacement dans lequel vous pouvez commencer à écrire du code dans votre projet. Comme la classe fournit les mêmes événements, propriétés et méthodes que la classe Microsoft.Office.Interop.Word.Document dans l'assembly PIA (Primary Interop Assembly) 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 Document
Un projet au niveau du document peut contenir un seul élément hôte Document. Vous ne pouvez pas ajouter de nouveaux éléments hôtes Document à votre projet au moment du design et vous ne pouvez pas créer par programme de nouveaux éléments hôtes Document au moment de l'exécution depuis 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
À partir du SP1, 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é.
Pour générer un élément hôte Document, utilisez la méthode GetVstoObject d'un objet Microsoft.Office.Interop.Word.Document quelconque. 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
Vue d'ensemble du modèle objet Word
Limitations de programmation des éléments hôtes et des contrôles hôtes
Autres ressources
Historique des modifications
Date |
Historique |
Raison |
|---|---|---|
|
Juillet 2008 |
Ajout d'informations relatives à l'utilisation d'éléments hôtes Document dans des projets au niveau de l'application. |
Modifications de fonctionnalités dans le SP1. |