Elemento host Workbook

Actualización: Julio de 2008

Se aplica a
La información de este tema sólo se aplica a los proyectos de Visual Studio Tools para Office y versiones de Microsoft Office especificados. Proyectos de nivel de documento Excel 2007 Excel 2003 Proyectos de nivel de aplicación Excel 2007 Para obtener más información, consulte Características disponibles por aplicación y tipo de proyecto.

El elemento de host Workbook es un objeto de libro que expone eventos y actúa como contenedor de componentes.

Cuando se crea una personalización de nivel de documento para Microsoft Office Excel, Visual Studio Tools para Office crea automáticamente un elemento host Workbook dentro del proyecto. Para hacer referencia al objeto Workbook se utiliza ThisWorkbook.

A partir de Visual Studio 2008 Service Pack 1 (SP1), puede obtener un elemento host Workbook en un proyecto de complemento en el nivel de la aplicación llamando al método GetVstoObject de un objeto Microsoft.Office.Interop.Excel.Workbook. Para obtener más información, vea Ampliar documentos de Word y libros de Excel en complementos en el nivel de la aplicación en tiempo de ejecución.

Comprender los elementos de host de libro

El elemento host Workbook no actúa como un contenedor para los controles host. Por consiguiente, no puede agregar ningún control visible al libro, pero puede agregar los componentes, como DataSet, para que todas las hojas de cálculo puedan compartirlos. En un proyecto en el nivel del documento, los componentes disponibles para el libro se pueden buscar en la ficha Componente, ficha Datos y ficha Todos los formularios Windows Forms del Cuadro de herramientas.

Haga doble clic en el elemento del proyecto ThisWorkbook en el Explorador de soluciones para mostrar el diseñador del libro y ver las propiedades y eventos del libro en la ventana Propiedades.

Nota:
Visual Studio Tools para Office no admite libros compartidos.

Eventos

Los siguientes eventos están disponibles para el elemento host 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

Vea también

Tareas

Ejemplo Excel Add-In Dynamic Controls

Conceptos

Ampliar documentos de Word y libros de Excel en complementos en el nivel de la aplicación en tiempo de ejecución

Información general sobre elementos y controles Host

Elemento host Worksheet

Limitaciones de programación de elementos y controles Host

Otros recursos

Controles Host de Excel

Historial de cambios

Fecha	Historial	Motivo
Julio de 2008	Se ha añadido información sobre el uso de elementos host de libros en complementos en el nivel de la aplicación.	Cambio de características de SP1.