Elemento host Worksheet

Actualización: Julio de 2008

Se aplica a
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. 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 host Worksheet es una hoja de cálculo que expone eventos y actúa como contenedor para los controles host y los controles de formularios Windows Forms.

Cuando se crea una nueva personalización de nivel de documento para Microsoft Office Excel, Visual Studio Tools para Office crea automáticamente tres elementos host Worksheet en el proyecto. Los nombres predeterminados de las hojas de cálculo son Sheet1, Sheet2 y Sheet3. Si crea una aplicación basada en un libro existente, el número de elementos host depende del número de hojas de cálculo en el libro.

Comprender los elementos host de una hoja de cálculo

De la misma manera que agrega controles de formularios Windows Forms a un formulario Windows Forms, puede agregar controles de formularios Windows Forms y controles host a un elemento host Worksheet.

En un proyecto en el nivel del documento, puede agregar elementos host Worksheet adicionales en tiempo de diseño; sin embargo, los elementos host Microsoft.Office.Tools.Excel.Worksheet no se crean automáticamente cuando agrega una hoja de cálculo mediante programación. Si agrega una hoja de cálculo en tiempo de ejecución a un proyecto en el nivel del documento, será del tipo Microsoft.Office.Interop.Excel.Worksheet y no podrá contener controles host ni controles de formularios Windows Forms.

A partir de Visual Studio 2008 Service Pack 1 (SP1), puede agregar en tiempo de ejecución hojas de cálculo a un complemento en el nivel de la aplicación y, a continuación, llamar al método GetVstoObject de un objeto Microsoft.Office.Interop.Excel.Worksheet para obtener un elemento host Worksheet. 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.

En proyectos de Excel, la hoja de cálculo es el vehículo primario para la interacción con el usuario. Si combina diferentes conjuntos de controles y escribe código, puede enlazar los controles a datos, recopilar información del usuario y responder a sus acciones.

Cambiar el nombre de la hoja de cálculo

En una personalización en el nivel del documento, puede cambiar el nombre de las hojas de cálculo en el diseñador de Visual Studio, pero esto únicamente cambia el nombre para mostrar de la hoja de cálculo. El nombre de programación sigue siendo el nombre predeterminado de la hoja de cálculo. Si cambia el nombre de la hoja de cálculo en la ventana Propiedades, solo se cambia el nombre de programación.

Eventos

Los eventos disponibles para el elemento host Worksheet son:

• ActivateEvent

• BeforeDoubleClick

• BeforeRightClick

• BindingContextChanged

• Calculate

• Change

• Deactivate

• Disposed

• FollowHyperlink

• PivotTableUpdate

• SelectionChange

• Shutdown

• Startup

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

Agregar controles a documentos de Office en tiempo de ejecución

Información general sobre elementos y controles Host

Elemento host Workbook

Limitaciones de programación de elementos y controles Host

Otros recursos

Controles en documentos de Office

Controles Host de Excel

Historial de cambios

Fecha	Historial	Motivo
Julio de 2008	Añadida información sobre el uso de elementos host de hojas de cálculo en complementos en el nivel de la aplicación.	Cambio de características de SP1.