Compartir a través de


Introducción a la programación de personalizaciones de nivel de documento para Word

Actualización: noviembre 2007

Se aplica a

La información de este tema sólo se aplica a los proyectos de Visual Studio Tools para Office y versiones de Microsoft Office especificados.

Tipo de proyecto

  • Proyectos de nivel de documento

Versión de Microsoft Office

  • Word 2003

  • Word 2007

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

Si ha empezado recientemente a crear personalizaciones de nivel de documento para Microsoft Office Word con Visual Studio Tools para Office, esto es lo que necesita saber.

Modelo de aplicación de documento único

Cada personalización de Word que crea se basa en un documento único. Para empezar a utilizar la personalización, el usuario final abre el documento o lo crea a partir de una plantilla de Word. Los eventos del documento, como por ejemplo desplazar el cursor a áreas específicas o hacer clic en botones y elementos de menús, pueden llamar a métodos de control de eventos del ensamblado. Para obtener más información, consulte Arquitectura de las personalizaciones de nivel de documento.

Programar documentos de Word mediante elementos y controles host

Los elementos host y controles host son clases que proporcionan el modelo de programación para las personalizaciones de nivel de documento.

Los elementos host proporcionan un punto de entrada para el código y también pueden hacer las veces de contenedor para controles como controles host o controles de formularios Windows Forms. Las personalizaciones de Word utilizan el elemento host Microsoft.Office.Tools.Word.Document. Este elemento host incluye un diseñador que es la representación visual del documento de Word en el proyecto, como un diseñador de formularios Windows Forms. En el proyecto, este elemento host se representa mediante la clase ThisDocument, que deriva del elemento host Microsoft.Office.Tools.Word.Document. Para obtener más información, consulte Información general sobre elementos y controles Host y Elemento host Document.

Los controles host se basan en objetos nativos de Word, como controles de contenido, marcadores y nodos XML. Los controles host proporcionan una funcionalidad similar a los objetos nativos de Word, pero también disponen de nuevos eventos, compatibilidad con diseñadores y capacidad de enlace de datos. Aparecen como objetos de primera clase en el modelo de programación de Visual Studio Tools para Office y en IntelliSense, lo que facilita las referencias a objetos específicos directamente en el código sin necesidad de navegar por el modelo de objetos de Word. Para obtener más información, consulte Información general sobre elementos y controles Host y Controles Host de Word.

Hay diferentes controles host disponibles en los proyectos de nivel de documento para Word 2003 y Word 2007. En ambos conjuntos de proyectos, puede utilizar los controles Bookmark y XMLNode. En los proyectos de Word 2007, también puede utilizar controles de contenido. Para obtener más información, vea Controles de contenido, Bookmark (Control) e XMLNode (Control).

Enlazar controles a los datos

Los controles de contenido y el control Bookmark se encuentran en la lista de controles que se pueden arrastrar desde la ventana Orígenes de datos. Al agregar controles de contenido y marcadores de esta manera, se enlazan automáticamente con el origen de datos que se configure mediante la ventana. Sin escribir ningún código, puede mostrar datos contenidos en bases de datos, servicios Web y objetos de su documento. Para obtener más información, vea Enlazar datos a controles.

Personalizar la interfaz de usuario de Word

La mayoría de las soluciones de Microsoft Office modifican la interfaz de usuario de la aplicación de Office para proporcionar formas en las que los usuarios puedan interactuar con la solución. Hay muchas maneras en las que se puede modificar la interfaz de usuario de Word mediante una personalización de nivel de documento. Por ejemplo, puede agregar controles a la cinta de opciones, puede mostrar un panel de acciones y puede crear etiquetas inteligentes que respondan a cadenas específicas que los usuarios escriben en el documento. Para obtener más información, consulte Personalización de la interfaz de usuario de Office.

Pasos siguientes

Para obtener una lista de temas que le sirvan de guía por algunas de las tareas comunes en la automatización de Word, vea Tareas comunes en la programación de Office.

Vea también

Tareas

Tutorial: Crear la primera personalización en el nivel del documento para Word

Conceptos

Tutoriales para Word

Soluciones de Word

Información general acerca del modelo de objetos de Word

Introducción a la escritura de código

Introducción a la programación de personalizaciones de nivel de documento para Excel

Otros recursos

Introducción (Visual Studio Tools para Office)