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

Este tutorial muestra cómo usar los botones y cuadros de texto en una personalización de nivel de documento para Microsoft Office Word.

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 controles al documento Word en un proyecto de nivel de documento en tiempo de diseño.

  • Rellenar un cuadro de texto cuando se hace clic en un botón.

    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.

Para crear un nuevo proyecto

  1. 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, 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 My Word Button (Mi botón de Word) a Explorador de soluciones.

Agregar controles al documento de Word

Los controles de interfaz de usuario están compuestos por un botón y 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 pestaña Controles comunes del Cuadro de herramientas, arrastre un TextBox control al documento.

    Nota:

    En Word, los controles se colocan de forma predeterminada en línea con el texto. Puede modificar la forma en que se insertan los controles y los objetos de forma cambiando el valor predeterminado en la pestaña Editar del cuadro de diálogo Opciones de Word.

  3. En el menú Ver, seleccione la ventana Propiedades.

  4. Busque TextBox1 en el cuadro desplegable Ventana propiedades y cambie la propiedad Name del cuadro de texto para mostrarText.

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

    Propiedad Valor
    Nombre insertText
    Texto Insertar texto

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

Rellenar el cuadro de texto cuando se hace clic en el botón

Cada vez que el usuario selecciona el botón, Hola mundo! se agrega al cuadro de texto.

Para escribir en el cuadro de texto cuando se haga clic en el botón

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

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

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

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

Prueba de la aplicación

Ahora puede probar el documento para asegurarse de que el mensaje Hola mundo! aparece en el cuadro de texto al seleccionar el botón.

Para probar el documento

  1. Presione F5 para ejecutar el proyecto.

  2. Haga clic en el botón .

  3. Confirme que Hola mundo! aparece en el cuadro de texto.

Pasos siguientes

Este tutorial muestra los conceptos básicos del uso de botones y cuadros de texto en documentos de Word. A continuación, podría realizar las siguientes tareas: