Compartir a través de

Elemento host del documento

El Document elemento host es un tipo que extiende el Document tipo desde el ensamblado de interoperabilidad principal para Word. El Document elemento host proporciona todas las mismas propiedades, métodos y eventos que un Document objeto, pero también expone eventos adicionales y actúa como contenedor para controles host y 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, vea Características disponibles por aplicación de Office y tipo de proyecto.

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

Comprender el elemento host del documento en proyectos de nivel de documento

Para acceder al documento del proyecto, use la ThisDocument clase . Al crear un proyecto de nivel de documento, Visual Studio genera la ThisDocument clase para que actúe como vínculo de comunicación entre Word y el código de personalización. La ThisDocument clase proporciona acceso a los miembros del Document elemento host para realizar tareas básicas en la personalización, como ejecutar código cuando se abre o cierra el documento. También puede usar la clase para agregar controles al documento. Al combinar diferentes conjuntos de controles y escribir 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 ThisDocument clase proporciona una ubicación en la que puede empezar a escribir código en el proyecto. Dado que la clase proporciona todas las mismas propiedades, métodos y eventos que el Document objeto en el ensamblado de interoperabilidad principal para Word, también puede usar ThisDocument para tener 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 solo puede contener un Document elemento host (es decir, la ThisDocument clase ). No puede agregar nuevos Document elementos host al proyecto en tiempo de diseño y no puede crear nuevos Document elementos host en tiempo de ejecución a partir de una personalización de nivel de documento.

Si crea un nuevo documento de Word en tiempo de ejecución, será del tipo Document. Dado que no es un elemento host, no puede contener ningún control 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).

Comprender los elementos host de documentos en proyectos a nivel de aplicación

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

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

Contenido relacionado

  • Last updated on