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

Artículo
08/10/2011

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.

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 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:

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 botón 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 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

Compruebe que el documento está abierto en el diseñador de Visual Studio.
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.
En el menú Ver, haga clic en Ventana Propiedades.
Busque TextBox1 en el cuadro desplegable de la ventana Propiedades y cambie la propiedad Name del cuadro de texto a displayText.
Arrastre un control Button al documento y cambie las siguientes propiedades.

Propiedad

Valor

Name

insertText

Text

Insert Text

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 agrega Hello World! (Hola a todos) al cuadro de texto.

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

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

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!";
}

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 proyectos de Office.
```
this.insertText.Click += new EventHandler(insertText_Click);
```

Probar la aplicación

Ahora es posible probar el documento para asegurarse de que el mensaje Hello World! aparece en el cuadro de texto al hacer clic en el botón.

Para probar el documento

Presione F5 para ejecutar el proyecto.
Haga clic en el botón.
Confirme que Hola a todos aparece 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:

Utilizar un cuadro combinado para cambiar el formato. Para obtener más información, vea Tutorial: Cambiar el formato de un documento utilizando controles CheckBox.
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