Élément hôte de classeur

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

L'élément hôte Workbook est un objet classeur qui expose des événements et agit comme un conteneur pour les composants.

Lorsque vous créez une personnalisation au niveau du document pour Microsoft Office Excel, Visual Studio Tools pour Office crée automatiquement un élément hôte Workbook dans le projet. Référencez le Workbook à l'aide de ThisWorkbook.

À compter de Visual Studio 2008 Service Pack 1 (SP1), vous pouvez obtenir un élément hôte Workbook dans un projet de complément d'application en appelant la méthode GetVstoObject d'un objet Microsoft.Office.Interop.Excel.Workbook. 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..

Fonctionnement des éléments hôtes de classeur

L'élément hôte Workbook n'agit pas comme un conteneur pour les contrôles hôtes. Par conséquent, vous ne pouvez pas ajouter de contrôles visibles au classeur, mais vous pouvez ajouter des composants, tels qu'un DataSet, afin que les composants puissent être partagés par toutes les feuilles de calcul. Dans un projet au niveau du document, les composants disponibles pour le classeur sont accessibles depuis l'onglet Composant, l'onglet Données et l'onglet Tous les Windows Forms de la boîte à outils.

Double-cliquez sur l'élément de projet ThisWorkbook dans l'Explorateur de solutions pour afficher le concepteur de classeurs et les propriétés et événements du classeur dans la fenêtre Propriétés.

Remarque :
Visual Studio Tools pour Office ne prend pas en charge les classeurs partagés.

Événements

Les événements suivants sont disponibles pour l'élément hôte Workbook :

• ActivateEvent

• AddinInstall

• AddinUninstall

• AfterXmlExport

• AfterXmlImport

• BeforeClose

• BeforePrint

• BeforeSave

• BeforeXmlExport

• BeforeXmlImport

• BindingContextChanged

• Deactivate

• Disposed

• New

• NewSheet

• Open

• PivotTableCloseConnection

• PivotTableOpenConnection

• RowsetComplete

• SheetActivate

• SheetBeforeDoubleClick

• SheetBeforeRightClick

• SheetCalculate

• SheetChange

• SheetDeactivate

• SheetFollowHyperlink

• SheetPivotTableUpdate

• SheetSelectionChange

• Shutdown

• Startup

• SyncEvent

• WindowActivate

• WindowDeactivate

• WindowResize

Voir aussi

Tâches

Contrôles dynamiques de complément Excel, exemple

Concepts

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

Vue d'ensemble des éléments hôtes et des contrôles hôtes

Élément hôte de feuille de calcul

Limitations de programmation des éléments hôtes et des contrôles hôtes

Autres ressources

Contrôles hôtes Excel

Historique des modifications

Date	Historique	Raison
Juillet 2008	Ajout d'informations relatives à l'utilisation d'éléments hôtes de classeur dans des compléments d'application.	Modifications de fonctionnalités dans le SP1.