Elemento host del documento

  • Artículo

El elemento host Document es un tipo que extiende el tipo Document del ensamblado de interoperabilidad primario de Word. Asimismo, el elemento host Document proporciona las mismas propiedades, métodos y eventos que un objeto Document y, además, también expone eventos adicionales y sirve de contenedor para los controles host y para los controles de Windows Forms.

Se aplica a: la información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO para Word. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

En los proyectos de nivel de documento, existe un elemento host Document predeterminado que representa al documento del proyecto. En los proyectos de complemento de VSTO, puede generar elementos host Document en tiempo de ejecución.

Descripción del elemento host del documento en proyectos de nivel de documento

Para obtener acceso al documento del proyecto, utilice la clase ThisDocument . Cuando se crea un proyecto de nivel de documento, Visual Studio 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 le da acceso a los miembros del elemento host Document para que pueda realizar tareas básicas durante la personalización, como por ejemplo, ejecutar el código cuando el documento se abre o se cierra. También puede usar esa clase para agregar controles al documento. Si combina diferentes conjuntos de controles y escribe código, puede enlazar los controles a los datos, recopilar información del usuario y responder a las acciones del usuario. Para obtener más información, consulte Personalizaciones de nivel de documento del programa.

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 el objeto Document que se encuentra en el ensamblado de interoperabilidad primario de Word, también puede usar ThisDocument para obtener acceso al modelo de objetos de Word. Para obtener más información, consulte Introducción al modelo de objetos de Word.

Limitaciones del elemento host del documento en proyectos de nivel de documento

Un proyecto de nivel de documento puede contener solamente un elemento host Document (es decir, la clase ThisDocument ). No puede agregar nuevos elementos host Document al proyecto en tiempo de diseño ni tampoco crear nuevos elementos host Document en tiempo de ejecución desde una personalización de nivel de documento.

Si crea un nuevo documento de Word en tiempo de ejecución, será del tipo Document. Como no se trata de un elemento host, este no puede contener controles host ni controles de Windows Forms. Para obtener más información sobre cómo crear documentos en tiempo de ejecución, vea How to: Programmatically create new documents (Cómo: Crear documentos nuevos mediante programación).

Descripción de los elementos host de documentos en proyectos de nivel de aplicación

En los proyectos de complemento VSTO, puede generar en tiempo de ejecución un elemento host Document para cualquier documento que esté abierto en Word. Puede usar el elemento host Document para agregar controles al documento asociado, o para administrar los eventos que no estén disponibles en los objetos Document .

Para generar un elemento host Document, use el método GetVstoObject. Para obtener más información, vea Extender documentos de Word y libros de Excel en complementos de VSTO en tiempo de ejecución.

Contenido relacionado