Compartir a través de

Tutorial: Mostrar texto en un cuadro de texto en un documento utilizando un botón

  • Artículo

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 botones y cuadros de texto en una personalización en el nivel del documento para Microsoft Office Word.

Este tutorial ilustra las tareas siguientes:

  • Agregar controles al documento de Word en un proyecto en el nivel del documento en tiempo de diseño.

  • Rellenar un cuadro de texto al hacer clic en un botón.

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.

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 botón 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 botón de Word al Explorador de soluciones.

Agregar controles al documento de Word

Los controles de interfaz de usuario se componen de un botón y de un cuadro de texto en el documento de Word.

Para agregar un botón y un cuadro de texto

  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 un control TextBox hasta el documento.

    Nota:

    En Word, los controles se colocan en línea con el texto de manera predeterminada. Es posible modificar la manera en que se insertan los controles y los objetos de forma, cambiando los valores predeterminados de la ficha Edición del cuadro de diálogo Opciones.

  3. En el menú Ver, haga clic en Ventana Propiedades.

  4. Busque TextBox1 en el cuadro desplegable de la ventana Propiedades y cambie la propiedad Name del cuadro de texto a displayText.

  5. Arrastre un control Button al documento y cambie las siguientes propiedades.

    Propiedad

    Valor

    Name

    insertText

    Text

    Insert Text

Ahora puede escribir el código que se ejecutará al hacer clic en el botón.

Rellenar el cuadro de texto al hacer clic en el botón

Cada vez que el usuario hace clic en el botón, se anexa Hola a todos al cuadro de texto.

Para escribir en el cuadro de texto al hacer clic en el botón

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

  2. Agregue el código siguiente al controlador del evento Click del botón.

    Private Sub insertText_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles insertText.Click

    Me.displayText.Text += "Hello World!"
End Sub

    private void insertText_Click(object sender, EventArgs e)
{
    this.displayText.Text += "Hello World!";
}

  3. En C#, debe agregar un controlador de eventos para el botón al evento Startup. Para obtener más información sobre cómo crear controladores de eventos, vea Cómo: Crear controladores de eventos en Visual Studio Tools para Office.

    this.insertText.Click += new EventHandler(insertText_Click);

Probar la aplicación

Ahora es posible probar el documento para asegurarse de que el mensaje Hola a todos aparece en el cuadro de texto al hacer clic en el botón.

Para probar el documento

  1. Presione F5 para ejecutar el proyecto.

  2. Haga clic en el botón.

  3. Confirme que aparece Hola a todos en el cuadro de texto.

Pasos siguientes

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

Vea también

Tareas

Cómo: Agregar controles de Windows Forms a documentos de Office

Conceptos

Información general sobre controles de formularios Windows Forms en documentos de Office

Tutoriales para Word

Información general sobre elementos y controles Host

Otros recursos

Ejemplos y tutoriales del desarrollo de Office