Compartir a través de


Tutorial: Cambio del formato de documento mediante controles CheckBox

En este tutorial, se muestra cómo usar los controles de Windows Forms en una personalización a nivel de documento de Microsoft Office Word para cambiar el formato del texto.

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

En este tutorial se muestran las siguientes tareas:

  • Añadiendo texto y un control al documento en un proyecto a nivel de documento en tiempo de diseño.

  • Aplicar formato al texto cuando se selecciona una opción.

    Para ver el resultado como ejemplo completado, vea el ejemplo de controles de Word en ejemplos de desarrollo de Office y tutoriales.

    Nota:

    El equipo puede mostrar nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las instrucciones siguientes. La edición de Visual Studio que tiene y la configuración que usa determinan estos elementos. Para obtener más información, consulte Personalizar el IDE.

Prerrequisitos

Necesitará los componentes siguientes para completar este tutorial:

Creación del proyecto

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

Creación de un nuevo proyecto

  1. 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, vea 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 de verificación y algo de texto en un control Bookmark al documento de Word. Las casillas presentan opciones al usuario para dar formato al texto.

Agregar tres casillas

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

  2. En la pestaña Controles comunes del Cuadro de herramientas, arrastre el primer CheckBox control al documento.

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

    Propiedad Importancia
    Nombre applyBoldFont
    Text Bold
  4. Presione Entrar para mover el punto de inserción debajo de la primera casilla.

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

    Propiedad Importancia
    Nombre applyItalicFont
    Text Italic
  6. Presione Entrar para mover el punto de inserción debajo de la segunda casilla.

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

    Propiedad Importancia
    Nombre applyUnderlineFont
    Text Subrayar

Agregar texto y un control de marcador

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

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

  2. En la pestaña Controles de Word del Cuadro de herramientas, arrastre un Bookmark control al 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 un Bookmark control denominado Bookmark1 al texto seleccionado del documento.

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

Dar formato al texto cuando se activa o desactiva una casilla

Cuando el usuario selecciona una opción de formato, cambie el formato del texto del documento.

Cambiar formato cuando se activa una casilla

  1. Haga clic ThisDocument con el botón derecho en el Explorador de soluciones y, a continuación, haga clic en Ver código en el menú contextual.

  2. Solo para C#, agregue las siguientes constantes a la clase ThisDocument .

    const int WordTrue = -1;
    const int WordFalse = 0;
    
  3. Agregue el código siguiente al Click controlador de eventos de la applyBoldFont casilla de verificación.

    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 Click controlador de eventos de la applyItalicFont casilla de verificación.

    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 Click controlador de eventos de la applyUnderlineFont casilla de verificación.

    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 Startup evento. Para obtener información sobre cómo crear controladores de eventos, vea How to: Create event handlers in Office projects.

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

Prueba de la aplicación

Ahora puede probar el documento para comprobar que el texto tiene el formato correcto al activar o desactivar una casilla.

Prueba del 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 conceptos básicos del uso de casillas y el cambio de formato de texto mediante programación en documentos de Word. Estas son algunas tareas que pueden venir a continuación: