Elemento host Document
El elemento host Document es un tipo que extiende el tipo Microsoft.Office.Interop.Word.Document del ensamblado de interoperabilidad primario para Word. El elemento host Document proporciona las mismas propiedades, métodos y eventos que un objeto Microsoft.Office.Interop.Word.Document, pero también expone eventos adicionales y sirve de contenedor para los controles host y controles de Windows Forms.
Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Word 2007 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.
En los proyectos de nivel de documento, hay un elemento host Document predeterminado que representa el documento en el proyecto. En los proyectos de nivel de aplicación, se pueden generar elementos host Document en tiempo de ejecución.
Entender los elementos host de documento en los proyectos en el nivel del 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 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, vea Programar personalizaciones de nivel de documento.
Nota
Las etiquetas inteligentes están desusadas en Excel 2010 y Word 2010. Para obtener más información, vea Información general sobre etiquetas inteligentes.
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 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, vea Información general acerca del modelo de objetos de Word.
Limitaciones del elemento host Document en los 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 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
En los proyectos de nivel de aplicación, se puede generar en tiempo de ejecución un elemento host Document para cualquier documento que esté abierto en Word. Se puede utilizar el elemento host Document para agregar controles y etiquetas inteligentes al documento asociado o controlar los eventos que no están disponibles en los objetos Microsoft.Office.Interop.Word.Document.
Para generar un elemento host Document, utilice el método GetVstoObject. 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
Automatizar Word con objetos extendidos
Limitaciones de programación de elementos y controles Host