Tutorial: Cambiar el formato de un documento utilizando controles CheckBox

Actualización: noviembre 2007

Se aplica a
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto Proyectos de nivel de documento Versión de Microsoft Office Word 2007 Word 2003 Para obtener más información, consulte Características disponibles por aplicación y tipo de proyecto.

En este tutorial se muestra cómo utilizar controles de formularios Windows Forms en una personalización en el nivel del documento para que Microsoft Office Word cambie el formato de texto.

Este tutorial ilustra las tareas siguientes:

• Agregar texto y un control al documento de un proyecto en el nivel del documento en tiempo de diseño.

• Aplicar formato al texto al seleccionar una opción.

Para ver el resultado como un ejemplo finalizado, vea Ejemplo Word Controls.

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).

• Microsoft Office Word 2003 o Microsoft Office Word 2007.

Visual Studio Tools para Office se instala, de forma predeterminada, con las versiones que se enumeran de Visual Studio. Para comprobar si está instalado, consulte Instalar Visual Studio Tools para Office.

Crear el proyecto

El primer paso es crear el proyecto de documento de Word.

Para crear un nuevo proyecto

• Cree un proyecto de documento de Word con el nombre Mi formato de Word. En el asistente, seleccione Crear un nuevo documento.

  Para obtener más información, consulte Cómo: Crear proyectos de Visual Studio para Office.

  Visual Studio abre el nuevo documento de Word en el diseñador y agrega el proyecto Mi formato de Word al Explorador de soluciones.

Agregar texto y controles al documento de Word

Para este tutorial, agregue tres casillas y algo de texto en un control Bookmark al documento de Word. Las casillas presentarán al usuario las opciones para dar formato al texto.

Para agregar tres casillas

1. Compruebe que el documento está abierto en el diseñador de Visual Studio.

2. En la ficha Controles comunes del Cuadro de herramientas, arrastre el primer control CheckBox hasta el documento.

3. En la ventana Propiedades, cambie las siguientes propiedades.

   Propiedad	Valor
   Nombre	applyBoldFont
   Texto	Negrita

4. Presione Entrar para colocar el punto de inserción debajo de la primera casilla.

5. Agregue una segunda casilla al documento debajo de la casilla ApplyBoldFont y cambie las siguientes propiedades.

   Propiedad	Valor
   Nombre	applyItalicFont
   Texto	Cursiva

6. Presione Entrar para colocar el punto de inserción debajo de la segunda casilla.

7. Agregue una tercera casilla al documento debajo de la casilla ApplyItalicFont y cambie las siguientes propiedades.

   Propiedad	Valor
   Nombre	applyUnderlineFont
   Texto	Subrayado

Para agregar texto y un control Bookmark

1. Coloque el punto de inserción debajo de los controles de casilla y escriba el siguiente texto:

   Haga clic en una casilla para cambiar el formato de este texto.

2. Desde la ficha Controles de Word del Cuadro de herramientas, arrastre un control Bookmark hasta el documento.

   Aparece el cuadro de diálogo Agregar control de marcador.

3. Seleccione el texto que agregó al documento y haga clic en Aceptar.

   Se agrega al texto seleccionado en el documento un control Bookmark llamado Bookmark1.

4. En la ventana Propiedades, cambie el valor de la propiedad (Name) a fontText**.**

A continuación, escriba el código para dar formato al texto cuando se active o desactive una de las casillas.

Dar formato al texto cuando se activa o desactiva una casilla

Cuando el usuario selecciona una opción de formato, se ha de cambiar el formato del texto en el documento.

Para cambiar el formato cuando se activa una casilla

1. Haga clic con el botón secundario del mouse en ThisDocument en el Explorador de soluciones y, a continuación, haga clic en la opción Ver código del menú de acceso directo.

2. Para C# únicamente, agregue las siguientes constantes a la clase ThisDocument.

   const int WordTrue = -1;
   const int WordFalse = 0;
   

3. Agregue el código siguiente al controlador de eventos Click de la casilla applyBoldFont.

   Private Sub applyBoldFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyBoldFont.Click
   
       Me.fontText.Bold = Me.applyBoldFont.Checked
   End Sub
   

   private void applyBoldFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyBoldFont.Checked == true)
       {
           this.fontText.Bold = WordTrue;
       }
       else
       {
           this.fontText.Bold = WordFalse;
       }
   }
   

4. Agregue el código siguiente al controlador de eventos Click de la casilla applyItalicFont.

   Private Sub applyItalicFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyItalicFont.Click
   
       Me.fontText.Italic = Me.applyItalicFont.Checked
   End Sub
   

   private void applyItalicFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyItalicFont.Checked == true)
       {
           this.fontText.Italic = WordTrue;
       }
       else
       {
           this.fontText.Italic = WordFalse;
       }
   }
   

5. Agregue el código siguiente al controlador de eventos Click de la casilla applyUnderlineFont.

   Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyUnderlineFont.Click
   
       If Me.applyUnderlineFont.Checked Then
           Me.fontText.Underline = Word.WdUnderline.wdUnderlineSingle
       Else
           Me.fontText.Underline = Word.WdUnderline.wdUnderlineNone
       End If
   End Sub
   

   private void applyUnderlineFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyUnderlineFont.Checked == true)
       {
           this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle;
       }
       else
       {
           this.fontText.Underline = Word.WdUnderline.wdUnderlineNone;
       }
   }
   

6. En C#, debe agregar controladores de eventos para los cuadros de texto al evento Startup. Para obtener información acerca de cómo crear controladores de eventos, vea Cómo: Crear controladores de eventos en Visual Studio Tools para Office.

   this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click);
   this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click);
   this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);
   

Probar la aplicación

Ahora puede probar el documento para comprobar que se aplica el formato correcto al texto cuando se activa o desactiva cada casilla.

Para probar el documento

1. Presione F5 para ejecutar el proyecto.

2. Active o desactive una casilla.

3. Confirme que el texto tiene el formato correcto.

Pasos siguientes

En este tutorial se muestran los aspectos básicos del uso de las casillas y del cambio del formato de texto de los documentos de Word mediante programación. Éstas son algunas de las tareas que pueden venir a continuación:

• Usar un botón para rellenar un cuadro de texto. Para obtener más información, vea Tutorial: Mostrar texto en un cuadro de texto en un documento utilizando un botón.

• Utilizar los botones de opción para seleccionar estilos de gráfico. Para obtener más información, vea Tutorial: Actualizar un gráfico en un documento utilizando botones de opción.

Vea también

Conceptos

Tutoriales para Word

NamedRange (Control)

Limitaciones de los controles de formularios Windows Forms en los documentos de Office

Otros recursos

Ejemplos y tutoriales del desarrollo de Office