Tutorial: Crear el primer complemento en el nivel de la aplicación para Word

Artículo
04/28/2010

Actualización: Julio de 2008

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 aplicación Versión de Microsoft Office Word 2007 Word 2003 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

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 aplicación

Versión de Microsoft Office

Word 2007
Word 2003

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

Este tutorial introductorio muestra cómo crear un complemento en el nivel de la aplicación para Microsoft Office Word. Las características que se crean en este tipo de solución están disponibles para la propia aplicación, con independencia de qué documentos están abiertos.

Este tutorial ilustra las tareas siguientes:

Crear un proyecto de complemento de Word para Word 2003 o Word 2007.
Escribir código que utiliza el modelo de objetos de Word para agregar texto a un documento al guardarlo.
Generar y ejecutar el proyecto para probarlo.
Limpiar el proyecto completado para que el complemento ya no se ejecute automáticamente en el 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 complemento de Word en Visual Studio

Inicie Visual Studio.
En el menú Archivo, elija Nuevo y haga clic en Proyecto.
En el panel Tipos de proyecto, expanda Visual C# o Visual Basic y, a continuación, expanda Office.
Seleccione la carpeta 2007 para desarrollar un complemento de Word 2007, o la carpeta 2003 para desarrollar un complemento de Word 2003.
En el panel Plantillas, seleccione Complemento de Word 2003 o Complemento de Word 2007.
En el cuadro Nombre, escriba FirstWordAddIn.
Haga clic en Aceptar.

Visual Studio crea el proyecto FirstWordAddIn y abre el archivo de código ThisAddIn en el editor.

Escribir código para agregar texto al documento guardado

A continuación, agregue código al archivo de código ThisAddIn. El nuevo código utiliza el modelo de objetos de Word para agregar texto reutilizable a cada documento guardado. De forma predeterminada, el archivo de código ThisAddIn contiene el código generado siguiente:

Una definición parcial de la clase ThisAddIn. Esta clase proporciona un punto de entrada para el código y proporciona acceso al modelo de objetos de Word. Para obtener más información, vea Elemento host AddIn. El resto de la clase ThisAddIn se define en un archivo de código oculto que no debe modificar.
Los controladores de eventos ThisAddIn_Startup y ThisAddIn_Shutdown. Se llama a estos controladores de eventos cuando Word carga y descarga el complemento. Use estos controladores de eventos para inicializar el complemento cuando éste se cargue y para limpiar los recursos cuando se descargue. Para obtener más información, vea Eventos de proyectos de Visual Studio Tools para Office.

Para agregar un párrafo de texto al documento guardado

En el archivo de código ThisAddIn, agregue el código siguiente a la clase ThisAddIn. El nuevo código define un controlador de eventos para el evento DocumentBeforeSave, que se provoca cuando se guarda un documento.

Cuando el usuario guarda un documento, el controlador de eventos agrega el nuevo texto al principio del documento.

Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _
    ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave
    Doc.Paragraphs(1).Range.InsertParagraphBefore()
    Doc.Paragraphs(1).Range.Text = "This text was added by using code."
End Sub

void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].Range.Text = "This text was added by using code.";
}

Nota:
Este código utiliza un valor de índice de 1 para tener acceso al primer párrafo de la colección 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#.

Si utiliza C#, agregue el siguiente código necesario al controlador de eventos ThisAddIn_Startup. Este código se utiliza para conectar el controlador de eventos Application_DocumentBeforeSave al evento DocumentBeforeSave.
```
this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);
```

Para modificar el documento al guardarlo, los ejemplos de código anteriores utilizan los objetos siguientes:

El campo Application de la clase ThisAddIn. El campo Application devuelve un objeto Microsoft.Office.Interop.Word.Application, que representa la instancia actual de Word.
El parámetro Doc del controlador del evento DocumentBeforeSave. El parámetro Doc es un objeto Microsoft.Office.Interop.Word.Document, que representa el documento guardado. Para obtener más información, vea Información general acerca del modelo de objetos de Word.

Probar el proyecto

Para probar el proyecto

Presione F5 para generar y ejecutar el proyecto.

Al generar el proyecto, el código se compila en un ensamblado que se incluye en la carpeta de resultado de compilación del proyecto. Visual Studio también crea un conjunto de entradas del Registro que permiten que Word detecte y cargue el complemento, y establece la configuración de seguridad en el equipo de desarrollo a fin de permitir la ejecución del complemento. Para obtener más información, vea Información general acerca del proceso de compilación de soluciones de Office.
En Word, guarde el documento activo.
Compruebe que el texto siguiente se agrega al documento.

Este texto se agregó mediante código.
Cierre Word.

Limpiar el proyecto

Al terminar de desarrollar un proyecto, quite el ensamblado de complemento, las entradas del Registro y la configuración de seguridad del equipo de desarrollo. De lo contrario, el complemento continuará ejecutándose cada vez que abra Word en este equipo.

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 un complemento básico en el nivel de la aplicación para Word, puede obtener más información sobre la programación de complementos en estos temas:

Tareas de programación generales que puede realizar en los complementos: Programar complementos de nivel de aplicación.
Tareas de programación específicas de los complementos de Word: Desarrollo de complementos de nivel de aplicación 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 tareas personalizado: Personalización de la interfaz de usuario de Office.
Generar y depurar los complementos en el nivel de la aplicación para Word: Generar y depurar soluciones de Office.
Implementar complementos en el nivel de la aplicación para Word: Implementar soluciones de Office.

Vea también

Historial de cambios

Fecha	Historial	Motivo
Julio de 2008	Se ha agregado un tema.	Mejora de la información.

Julio de 2008

Se ha agregado un tema.

Mejora de la información.

Compartir a través de