Compartir a través de


Tutorial: Cambio del formato de documento mediante controles CheckBox

En este tutorial se muestra cómo usar controles de Windows Forms en una personalización de nivel de documento para Que Microsoft Office Word cambie el formato de 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, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

En este tutorial se muestran las tareas siguientes:

  • Agregar texto y un control al documento en un proyecto de 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:

    Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. 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 Personalizar el IDE.

Requisitos previos

Necesitará los componentes siguientes para completar este tutorial:

Creación del proyecto

El primer paso es crear un proyecto de tipo 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 a Explorador de soluciones.

Agregar texto y controles al documento de Word

Para este tutorial, agregue tres casillas de verificación y algún texto en un Bookmark control 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 Valor
    Nombre applyBoldFont
    Texto Negrita
  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 Valor
    Nombre applyItalicFont
    Texto Cursiva
  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 Valor
    Nombre applyUnderlineFont
    Texto Subrayado

Agregar texto y un control Bookmark

  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 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. A continuación, podría realizar las siguientes tareas: