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

Actualización: Julio de 2008

Este tutorial preliminar muestra cómo crear una personalización en el nivel del documento para Microsoft Office Word. Las características que se crean en este tipo de solución sólo están disponibles cuando está abierto un documento concreto. No puede utilizar una personalización en el nivel del documento para realizar modificaciones en el nivel de la aplicación, por ejemplo, mostrar una nueva ficha Cinta de opciones al abrir el documento.

Este tutorial ilustra las tareas siguientes:

• Crear un proyecto de documento de Word para Word 2003 o Word 2007.

• Agregar texto al documento hospedado en el diseñador de Visual Studio.

• Escribir código que utiliza el modelo de objetos de Word para agregar texto al documento al abrirlo.

• Generar y ejecutar el proyecto para probarlo.

• Limpiar el proyecto para quitar archivos de compilación innecesarios y la configuración de seguridad del equipo de desarrollo.

Nota:
Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

• Visual Studio Tools para Office (componente opcional de Visual Studio 2008 Professional y Visual Studio Team System).

• Word 2003 o Word 2007.

De manera predeterminada, Visual Studio Tools para Office se instala con las versiones enumeradas de Visual Studio. Para comprobar si está instalado en su equipo, vea Instalar Visual Studio Tools para Office.

Creación del proyecto

Para crear un nuevo proyecto de documento de Word en Visual Studio

1. Inicie Visual Studio.

2. En el menú Archivo, elija Nuevo y haga clic en Proyecto.

3. En el panel Tipos de proyecto, expanda Visual C# o Visual Basic y, a continuación, expanda Office.

4. Seleccione la carpeta 2007 para desarrollar una personalización de Word 2007, o la carpeta 2003 para desarrollar una personalización de Word 2003.

   Nota:
   Para desarrollar una personalización en el nivel del documento para una versión de Word determinada, esa versión debe estar instalada en el equipo de desarrollo.

5. En el panel Plantillas, seleccione Documento de Word 2003 o Documento de Word 2007.

6. En el cuadro Nombre, escriba FirstDocumentCustomization.

7. Haga clic en Aceptar.

   Se abre el Asistente para proyectos de Visual Studio Tools para Office.

8. Seleccione Crear un nuevo documento y haga clic en Aceptar.

   Visual Studio crea el proyecto FirstDocumentCustomization y agrega el documento FirstDocumentCustomization y el archivo de código ThisDocument al proyecto. El documento FirstDocumentCustomization se abre automáticamente en el diseñador.

Cerrar y volver a abrir el documento en el diseñador

Si cierra deliberada o accidentalmente el documento en el diseñador mientras está desarrollando el proyecto, puede volver a abrirlo.

Para cerrar y volver a abrir el documento en el diseñador

1. Cierre el documento haciendo clic en el botón Cerrar (X) de la ventana del diseñador.

2. En el Explorador de soluciones, haga clic con el botón secundario en el archivo de código ThisDocument y seleccione Ver diseñador.

   O bien

   En el Explorador de soluciones, haga doble clic en el archivo de código ThisDocument.

Agregar texto al documento en el diseñador

Puede diseñar la interfaz de usuario de la personalización modificando el documento que está abierto en el diseñador. Por ejemplo, puede agregar texto, tablas o controles de Word. Para obtener más información sobre cómo usar el diseñador, vea Información general sobre documentos de Office en el entorno de Visual Studio.

Para agregar texto al documento utilizando el diseñador

• En el documento que está abierto en el diseñador, escriba el texto siguiente.

  Este texto se agregó usando el diseñador.

Agregar texto al documento mediante programación

A continuación, agregue código al archivo de código ThisDocument. El nuevo código utiliza el modelo de objetos de Word para agregar un segundo párrafo de texto al documento. De forma predeterminada, el archivo de código ThisDocument contiene el código generado siguiente:

• Una definición parcial de la clase ThisDocument, que representa el modelo de programación del documento y proporciona acceso al modelo de objetos de Word. Para obtener más información, vea Elemento host Document y Información general acerca del modelo de objetos de Word. El resto de la clase ThisDocument se define en un archivo de código oculto que no debe modificar.

• Los controladores de eventos ThisDocument_Startup y ThisDocument_Shutdown. Se llama a estos controladores de eventos cuando el documento se abre y se cierra. Utilice estos controladores de eventos para inicializar la personalización cuando se abre el documento y para limpiar los recursos que utiliza la personalización cuando se cierra el documento. Para obtener más información, vea Eventos de proyectos de Visual Studio Tools para Office.

Para agregar un segundo párrafo de texto al documento mediante código

1. En el Explorador de soluciones, haga clic con el botón secundario en ThisDocument y, a continuación, haga clic en Ver código.

   El archivo de código se abre en Visual Studio.

2. Reemplace el controlador de evento ThisDocument_Startup con el código siguiente. Cuando se abre el documento, este código agrega un segundo párrafo de texto al documento.

   Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       Me.Paragraphs(1).Range.InsertParagraphAfter()
       Me.Paragraphs(2).Range.Text = "This text was added by using code."
   End Sub
   

   private void ThisDocument_Startup(object sender, System.EventArgs e)
   {
       this.Paragraphs[1].Range.InsertParagraphAfter();
       this.Paragraphs[2].Range.Text = "This text was added by using code.";
   }
   

   Nota:
   Este código utiliza el valor de índice 1 para tener acceso al primer párrafo en la propiedad Paragraphs. Aunque Visual Basic y Visual C# utilizan matrices basadas en 0, el límite de matriz inferior de la mayoría de las colecciones del modelo de objetos de Word es 1. Para obtener más información, vea Programar con Visual Basic frente a C#.

Probar el proyecto

Para probar el documento

1. Presione F5 para generar y ejecutar el proyecto.

   Al generar el proyecto, el código se compila en un ensamblado asociado al documento. Visual Studio coloca una copia del documento y el ensamblado en la carpeta de resultados de compilación del proyecto y establece la configuración de seguridad en el equipo de desarrollo para permitir que se ejecute la personalización. Para obtener más información, vea Información general acerca del proceso de compilación de soluciones de Office.

2. En el documento, compruebe que ve el texto siguiente.

   Este texto se agregó usando el diseñador.

   Este texto se agregó mediante código.

3. Cierre el documento.

Limpiar el proyecto

Cuando haya terminado de desarrollar un proyecto, debe quitar los archivos de la carpeta de resultados de compilación y la configuración de seguridad creada por el proceso de compilación.

Para limpiar el proyecto completado en el equipo de desarrollo

• En el menú Generar de Visual Studio, haga clic en Limpiar solución.

Pasos siguientes

Ahora que ha creado una personalización en el nivel del documento básico para Word, puede obtener más información sobre la programación de personalizaciones en estos temas:

• Tareas de programación generales que puede realizar en personalizaciones en el nivel del documento: Programar personalizaciones de nivel de documento.

• Tareas de programación específicas de las personalizaciones en el nivel del documento para Word: Desarrollo de personalizaciones de nivel de documento de Word.

• Utilizar el modelo de objetos de Word: Información general acerca del modelo de objetos de Word.

• Personalizar la interfaz usuario de Word, por ejemplo, agregando una ficha personalizada a la cinta de opciones o creando su propio panel de acciones: Personalización de la interfaz de usuario de Office.

• Utilizar objetos de Word extendidos proporcionados por Visual Studio Tools para Office para realizar tareas que no son posibles con el modelo de objetos de Word (por ejemplo, hospedar controles administrados en documentos y enlazar controles de Word a datos utilizando el modelo de enlace de datos de Windows Forms): Automatizar Word con objetos extendidos.

• Generar y depurar personalizaciones en el nivel del documento para Word: Generar y depurar soluciones de Office.

• Implementar personalizaciones en el nivel del documento para Word: Implementar soluciones de Office.

Vea también

Conceptos

Información general sobre el desarrollo de soluciones de Office

Desarrollo de personalizaciones de nivel de documento de Word

Programar personalizaciones de nivel de documento

Información general acerca del modelo de objetos de Word

Automatizar Word con objetos extendidos

Personalización de la interfaz de usuario de Office

Información general sobre las plantillas de proyecto en Visual Studio Tools para Office

Referencia

Plantilla de proyecto de documentos de Word

Otros recursos

Generar y depurar soluciones de Office

Implementar soluciones de Office

Historial de cambios