Compartir a través de

Introducción al modelo de objetos de Word

Al desarrollar soluciones de Word en Visual Studio, interactuará con el modelo de objetos de Word. Este modelo de objetos consta de clases e interfaces que se proporcionan en el ensamblado de interoperabilidad principal para Word y se definen en el Microsoft.Office.Interop.Word espacio de nombres .

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 este tema se proporciona una breve introducción al modelo de objetos de Word. Para obtener más información sobre todo el modelo de objetos de Word, vea Usar la documentación del modelo de objetos de Word.

Para obtener información sobre el uso del modelo de objetos de Word para realizar tareas específicas, vea los temas siguientes:

Descripción del modelo de objetos de Word

Word proporciona cientos de objetos con los que puede interactuar. Estos objetos se organizan en una jerarquía que sigue estrechamente la interfaz de usuario. En la cima de la jerarquía está el objeto Application. Este objeto representa la instancia actual de Word. El Application objeto contiene los Documentobjetos , Selection, Bookmarky Range . Cada uno de estos objetos tiene muchos métodos y propiedades a los que puede acceder para manipular e interactuar con el objeto .

En la ilustración siguiente se muestra una vista de estos objetos en la jerarquía del modelo de objetos de Word.

Gráfico del modelo de objetos de Word

A primera vista, los objetos parecen superponerse. Por ejemplo, los Document objetos y Selection son miembros del Application objeto , pero el Document objeto también es miembro del Selection objeto . Document y Selection contienen Bookmark y Range objetos. La superposición existe porque hay varias maneras de acceder al mismo tipo de objeto. Por ejemplo, se aplica formato a un Range objeto ; pero es posible que desee acceder al intervalo de la selección actual, de un párrafo determinado, de una sección o de todo el documento.

En las secciones siguientes se describen brevemente los objetos de nivel superior y cómo interactúan entre sí. Estos objetos incluyen los cinco siguientes:

  • Objeto de aplicación

  • Document (objeto)

  • Objeto de selección

  • Objeto de rango

  • Bookmark (objeto)

    Además del modelo de objetos de Word, los proyectos de Office de Visual Studio proporcionan elementos host y controles host que extienden algunos objetos en el modelo de objetos de Word. Los elementos host y los controles host se comportan como los objetos de Word que extienden, pero también tienen funcionalidades adicionales, como funcionalidades de enlace de datos y eventos adicionales. Para obtener más información, consulte Automatizar Word usando objetos extendidos y Descripción general de elementos y controles del host.

Objeto de aplicación

El Application objeto representa la aplicación word y es el elemento primario de todos los demás objetos. Los componentes normalmente se utilizan para Word de manera integral. Puede usar sus propiedades y métodos para controlar el entorno de Word.

En los proyectos de complemento de VSTO, puede acceder al objeto Application mediante el campo Application de la clase ThisAddIn. Para obtener más información, consulte Complementos del programa VSTO.

En los proyectos de nivel de documento, puede acceder al objeto Application mediante la propiedad Application de la clase ThisDocument.

Document (objeto)

El Document objeto es fundamental para programar Word. Representa un documento y todo su contenido. Al abrir un documento o crear un nuevo documento, se crea un nuevo Document objeto, que se agrega a la Documents colección del Application objeto . El documento que tiene el foco se denomina documento activo. Se representa mediante la ActiveDocument propiedad del Application objeto .

Las herramientas de desarrollo de Office en Visual Studio amplían el Document objeto proporcionando el Document tipo . Este tipo es un elemento host que proporciona acceso a todas las características de un Document objeto y agrega eventos adicionales y la capacidad de agregar controles administrados.

Al crear un proyecto de nivel de documento, puede acceder a los miembros de Document mediante la clase generada ThisDocument en su proyecto. Puede acceder a los miembros del Document elemento host mediante las palabras clave Me o esta desde el código de la ThisDocument clase, o mediante Globals.ThisDocument desde el código fuera de la ThisDocument clase. Para obtener más información, consulte Personalizaciones de nivel de documento del programa. Por ejemplo, para seleccionar el primer párrafo del documento, use el código siguiente.

this.Paragraphs[1].Range.Select();

En los proyectos de complemento de VSTO, puede generar Document elementos host en tiempo de ejecución. Puede usar el elemento host generado para agregar controles al documento asociado. 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.

Objeto de selección

El Selection objeto representa el área que está seleccionada actualmente. Al realizar una operación en la interfaz de usuario de Word, como poner el texto en negrita, selecciona o resalta el texto y, a continuación, aplica el formato. El Selection objeto siempre está presente en un documento. Si no se selecciona nada, representa el punto de inserción. Además, una selección puede abarcar varios bloques de texto que no son contiguos.

Objeto de rango

El Range objeto representa un área contigua en un documento y se define mediante una posición de carácter inicial y una posición de carácter final. No está limitado a un único objeto Range. Puede definir varios Range objetos en el mismo documento. Un Range objeto tiene las siguientes características:

  • Puede constar del punto de inserción por sí solo, un intervalo de texto o todo el documento.

  • Incluye caracteres que no se imprimen, como espacios, caracteres de tabulación y marcas de párrafo.

  • Puede ser el área representada por la selección actual o puede representar un área diferente de la selección actual.

  • No es visible en un documento, a diferencia de una selección, que siempre está visible.

  • No se guarda con un documento y solo existe mientras se ejecuta el código.

    Al insertar texto al final de un intervalo, Word expande automáticamente el intervalo para incluir el texto insertado.

Objetos de control de contenido

Un ContentControl proporciona una manera de controlar el ingreso y la presentación de texto y otros tipos de contenido en documentos de Word. Un ContentControl puede mostrar varios tipos diferentes de interfaz de usuario que están optimizados para su uso en documentos de Word, como un control de texto enriquecido, un selector de fechas o un cuadro combinado. También puede usar un ContentControl para impedir que los usuarios editen secciones del documento o plantilla.

Visual Studio extiende el ContentControl objeto a varios controles host diferentes. Mientras que el ContentControl objeto puede mostrar cualquiera de los diferentes tipos de interfaz de usuario que están disponibles para los controles de contenido, Visual Studio proporciona un tipo diferente para cada control de contenido. Por ejemplo, puede usar un RichTextContentControl para crear un control de texto enriquecido, o puede usar un DatePickerContentControl para crear un selector de fechas. Estos controles host se comportan como el nativo ContentControl, pero tienen eventos adicionales y funcionalidades de enlace de datos. Para obtener más información, vea Controles de contenido.

Bookmark (objeto)

El Bookmark objeto representa un área contigua en un documento, con una posición inicial y una posición final. Puede usar marcadores para marcar una ubicación en un documento o como contenedor para el texto de un documento. Un Bookmark objeto puede estar formado por el punto de inserción o ser tan grande como todo el documento. Un Bookmark tiene las siguientes características que lo diferencian del objeto Range:

  • Puede asignar un nombre al marcador en tiempo de diseño.

  • Bookmark Los objetos se guardan con el documento y, por tanto, no se eliminan cuando el código deja de ejecutarse o se cierra el documento.

  • Los marcadores se pueden ocultar o hacer visibles estableciendo la ShowBookmarks propiedad del View objeto en false o true.

    Visual Studio extiende el Bookmark objeto proporcionando el Bookmark control host. El Bookmark control host se comporta como un nativo Bookmark, pero tiene eventos adicionales y funcionalidades de enlace de datos. Puedes enlazar datos a un control de marcador en un documento de la misma manera que enlazas los datos a un control de cuadro de texto en un Formulario Windows Forms. Para obtener más información, vea Control Bookmark.

Uso de la documentación del modelo de objetos de Word

Para obtener información completa sobre el modelo de objetos de Word, puede consultar la referencia del ensamblado de interoperabilidad primario (PIA) de Word y la referencia del modelo de objetos de Visual Basic para Aplicaciones (VBA).

Referencia del ensamblado de interoperabilidad principal

En la documentación de referencia de PIA de Word se describen los tipos del ensamblado de interoperabilidad principal para Word. Esta documentación está disponible en la siguiente ubicación: Referencia del ensamblado de interoperabilidad principal de Word 2010.

Para obtener más información sobre el diseño del PIA de Word, como las diferencias entre clases e interfaces en el PIA y cómo se implementan los eventos del PIA, vea Información general de las clases e interfaces en los ensamblados de interoperabilidad primarios de Office.

Referencia del modelo de objetos de VBA

La referencia del modelo de objetos de VBA documenta el modelo de objetos de Word, ya que se expone al código VBA. Para obtener más información, vea Referencia del modelo de objetos de Word 2010.

Todos los objetos y miembros de la referencia del modelo de objetos VBA corresponden a tipos y miembros del PIA de Word. Por ejemplo, el objeto Document de la referencia del modelo de objetos VBA corresponde al Document objeto del PIA de Word. Aunque la referencia del modelo de objetos de VBA proporciona ejemplos de código para la mayoría de las propiedades, métodos y eventos, debe traducir el código VBA en esta referencia a Visual Basic o Visual C# si desea usarlos en un proyecto de Word que cree mediante Visual Studio.

Contenido relacionado

  • Last updated on