Tutorial: Cambiar el formato de un documento utilizando controles CheckBox

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.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento para Word 2007 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

En este tutorial se muestran 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 consultar el resultado como ejemplo completo, vea el Ejemplo Word Controls en Ejemplos y tutoriales del desarrollo de Office.

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:

-

Una edición de Visual Studio 2010 que incluye las herramientas para desarrolladores de Microsoft Office. Para obtener más información, vea [Configurar un equipo para desarrollar soluciones de Office](bb398242\(v=vs.100\).md).

• Word 2007 o Word 2010.

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 Office en Visual Studio.

  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
   Name	applyBoldFont
   Text	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
   Name	applyItalicFont
   Text	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
   Name	applyUnderlineFont
   Text	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ú contextual.

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 proyectos de 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 radio para seleccionar estilos de gráfico. Para obtener más información, vea Tutorial: Actualizar un gráfico en un documento utilizando botones de radio.

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