Élément hôte AddIn

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. Type de projet Projets au niveau de l'application Version de Microsoft Office Version 2007 de Microsoft Office System Microsoft Office 2003 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

La classe Microsoft.Office.Tools.AddIn correspond à l'élément hôte des compléments d'application que vous créez à l'aide de Visual Studio Tools pour Office. Un élément hôte est une classe d'une solution Visual Studio Tools pour Office qui fournit le point d'entrée de votre code.

Présentation des classes AddIn et ThisAddIn

La classe AddIn fournit les fonctionnalités principales partagées par tous les compléments Visual Studio Tools pour Office. Toutefois, vous ne devez pas instancier cette classe de manière explicite, ni l'utiliser directement dans votre code.

Utilisez plutôt la classe ThisAddIn. Visual Studio Tools pour Office génère cette classe dans votre projet de complément afin d'établir un lien entre l'application Microsoft Office et le code du complément. La classe ThisAddIn dérive de AddIn. Visual Studio Tools pour Office instancie automatiquement cette classe lorsqu'une application Microsoft Office charge votre complément.

La classe ThisAddIn fournit un emplacement dans lequel vous pouvez commencer à écrire du code dans votre projet. Vous pouvez également utiliser ThisAddIn pour effectuer différentes tâches (accéder au modèle objet de l'application hôte, par exemple). Pour plus d'informations, consultez Programmation de compléments d'application.

Utilisation des classes AddIn et ThisAddIn dans les projets de complément Outlook 2007

Les projets de complément conçus pour Microsoft Office Outlook 2007 utilisent un autre élément hôte, Microsoft.Office.Tools.Outlook.OutlookAddIn. Cette classe dérive de AddIn et ajoute des fonctionnalités supplémentaires afin d'assurer la prise en charge des zones de formulaire. Pour plus d'informations sur les zones de formulaire, consultez Création de zones de formulaire Outlook.

Dans les projets de complément pour Outlook 2007, la classe ThisAddIn dérive de OutlookAddIn. Vous utilisez la classe ThisAddIn dans les compléments Outlook 2007 de la même manière que dans les compléments conçus pour les autres applications Microsoft Office.

Membres à utiliser pour les différentes tâches

Le tableau suivant décrit les tâches courantes et répertorie les membres de la classe ThisAddIn permettant d'effectuer ces tâches.

Tâche	Membre à utiliser
Exécuter le code pour initialiser le complément lorsque celui-ci est chargé.	Ajouter le code à la méthode ThisAddIn_Startup. Il s'agit du gestionnaire d'événements par défaut pour l'événement Startup. Pour plus d'informations, consultez Événements de projet Visual Studio Tools pour Office.
Exécuter le code pour nettoyer les ressources utilisées par le complément avant que celui-ci soit déchargé.	Ajouter le code à la méthode ThisAddIn_Shutdown. Il s'agit du gestionnaire d'événements par défaut pour l'événement Shutdown. Pour plus d'informations, consultez Événements de projet Visual Studio Tools pour Office.
Automatiser l'application hôte en accédant au modèle d'objet.	Utiliser le champ Application de la classe ThisAddIn. Cette tâche retourne une instance de la classe Application de l'application compatible avec votre complément. Pour plus d'informations, consultez Programmation de compléments d'application.
Créez une balise active qui puisse être reconnue dans tout document Word ou classeur Excel ouvert. Cette fonctionnalité est une des nouveautés de Visual Studio 2008 Service Pack 1 (SP1).	Utiliser le champ VstoSmartTags de la classe ThisAddIn. Ce champ est uniquement disponible dans les projets de complément pour Excel 2007 et Word 2007 que vous créez après avoir installé le SP1. Pour plus d'informations, consultez Vue d'ensemble des balises actives.
Exposer des objets de votre complément à d'autres solutions Microsoft Office.	Substituer la méthode RequestComAddInAutomationService. Pour plus d'informations, consultez Appel de code dans des compléments d'application à partir d'autres solutions Office.
Personnaliser une fonctionnalité de la version 2007 de Microsoft Office System en implémentant une interface d'extensibilité.	Substituer la méthode RequestService pour retourner une instance d'une classe qui implémente l'interface. Pour plus d'informations, consultez Personnalisation des fonctionnalités de l'interface utilisateur à l'aide d'interfaces d'extensibilité. Remarque : Pour personnaliser l'interface utilisateur du ruban, vous pouvez également substituer la méthode CreateRibbonExtensibilityObject.

Voir aussi

Tâches

Procédure pas à pas : appel de code dans un complément d'application à partir de VBA

Concepts

Programmation de compléments d'application

Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution.

Personnalisation des fonctionnalités de l'interface utilisateur à l'aide d'interfaces d'extensibilité

Appel de code dans des compléments d'application à partir d'autres solutions Office

Mise en route de la programmation de compléments d'application

Événements de projet Visual Studio Tools pour Office

Historique des modifications

Date	Historique	Raison
Juillet 2008	Ajout d'informations relatives à l'insertion de balises actives dans les documents à l'aide de compléments d'application.	Modifications de fonctionnalités dans le SP1.