Elemento host Document
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
Proyectos de nivel de aplicación
Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto. |
El elemento host Document representa un documento de Word que expone eventos y actúa como contenedor para los controles host y los controles de Windows Forms. El elemento host Document también proporciona las mismas propiedades, los mismos métodos y los mismos eventos que la clase Microsoft.Office.Interop.Word.Document en el ensamblado de interoperabilidad primario para Word.
En los proyectos en el nivel del documento, hay un elemento host Document que representa el documento en el proyecto. A partir de Visual Studio 2008 Service Pack 1 (SP1), también puede generar elementos host Document en tiempo de ejecución utilizando complementos en el nivel de la aplicación para Word 2007.
Entender los elementos host de documento en los proyectos en el nivel del documento
Para tener acceso mediante programación al documento en el proyecto, utilice la clase ThisDocument. Al crear un proyecto en el nivel del documento, Visual Studio Tools para Office genera la clase ThisDocument para que sirva como vínculo de comunicación entre Word y el código de personalización. La clase ThisDocument se deriva de la clase de elemento host Document. Visual Studio Tools para Office crea automáticamente instancias de la clase ThisDocument cuando se abre el documento en tiempo de ejecución. No debe intentar crear instancias de la clase Document directamente en el código.
La clase ThisDocument le da acceso a los miembros del elemento host Document para realizar las tareas básicas durante la personalización, por ejemplo, ejecutar código cuando el documento se abre o se cierra. También puede utilizar la clase para agregar controles y etiquetas inteligentes al documento. Si combina diferentes conjuntos de controles y escribe código, puede enlazar los controles a datos, recopilar información del usuario y responder a acciones del usuario. Para obtener más información, consulte Programar personalizaciones de nivel de documento.
La clase ThisDocument proporciona una ubicación en la que puede empezar a escribir el código del proyecto. Como esta clase proporciona las mismas propiedades, métodos y eventos que la clase Microsoft.Office.Interop.Word.Document en el ensamblado de interoperabilidad primario para Word, también puede utilizar ThisDocument para obtener acceso al modelo de objetos de Word. Para obtener más información, consulte Información general acerca del modelo de objetos de Word.
Limitaciones del elemento host Document
Un proyecto de nivel de documento sólo puede contener un elemento host Document. No puede agregar nuevos elementos host Document al proyecto en tiempo de diseño, ni tampoco crear mediante programación nuevos elementos host Document en tiempo de ejecución desde una personalización en el nivel del documento.
Si crea un nuevo documento de Word en tiempo de ejecución, será del tipo Microsoft.Office.Interop.Word.Document. Como no se trata de un elemento host, no puede contener controles host ni controles de formularios Windows Forms. Para obtener más información sobre cómo crear documentos en tiempo de ejecución, vea Cómo: Crear nuevos documentos.
Entender los elementos host de documento en los proyectos en el nivel de la aplicación
A partir del SP1, puede generar en tiempo de ejecución un elemento host Document para cualquier documento que esté abierto en Word. Puede utilizar el elemento host Document para agregar controles y etiquetas inteligentes al documento asociado.
Para generar un elemento host Document, utilice el método GetVstoObject de cualquier objeto Microsoft.Office.Interop.Word.Document. 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.
Vea también
Conceptos
Información general sobre elementos y controles Host
Información general acerca del modelo de objetos de Word
Limitaciones de programación de elementos y controles Host
Otros recursos
Historial de cambios
Fecha |
Historial |
Motivo |
---|---|---|
Julio de 2008 |
Se agrega información sobre cómo utilizar elementos host Document en proyectos en el nivel de la aplicación. |
Cambio de características de SP1. |