Tutorial: Insertar texto en un documento de un recuadro de acciones

Artículo
08/10/2011

En este tutorial se muestra el modo de crear un panel de acciones en un documento de Microsoft Office Word. El panel de acciones contiene dos controles que recopilan datos y, a continuación, envían el texto al documento.

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:

Diseñar una interfaz con los controles de formularios Windows Forms en un control del panel de acciones.
Mostrar el panel de acciones cuando se abra la aplicació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 en las siguientes instrucciones. La edición de Visual Studio que tenga y la configuración que esté utilizando determinan estos elementos. Para obtener más información, vea Trabajar con valores de configuración.

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 panel de acciones básico. 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 panel de acciones básico al Explorador de soluciones.

Agregar texto y marcadores al documento

El panel de acciones enviará el texto a los marcadores del documento. Para diseñar el documento, escriba algún texto para crear un formulario básico.

Para agregar texto al documento

Escriba el texto siguiente en el documento de Word:

21 de marzo de 2008

Nombre

Dirección

Este es un ejemplo de un panel de acciones básico en Word.

Puede agregar un control Bookmark al documento si lo arrastra desde el Cuadro de herramientas de Visual Studio o si utiliza el cuadro de diálogo Marcador de Word.

Para agregar un control para marcador al documento

Desde la ficha Controles de Word del Cuadro de herramientas, arrastre un control Bookmark al documento.

Aparece el cuadro de diálogo Agregar control de marcador.
Seleccione la palabra Nombre, sin seleccionar la marca de párrafo, y haga clic en Aceptar.

Nota

La marca de párrafo debe estar fuera del marcador. Si no se ven las marcas de párrafo en el documento, haga clic en el menú Herramientas, elija Herramientas de Microsoft Office Word y, a continuación, haga clic en Opciones. Haga clic en la ficha Ver y active la casilla Marcas de párrafo en la sección Marcas de formato del cuadro de diálogo Opciones.
En la ventana Propiedades, cambie la propiedad Nombre de Bookmark1 a showName.
Seleccione la palabra Dirección, sin seleccionar la marca de párrafo.
En la pestaña Insertar de la cinta de opciones, en el grupo Vínculos, haga clic en Marcador.
En el cuadro de diálogo Marcador, escriba showAddress en el cuadro Nombre de marcador y haga clic en Agregar.

Agregar controles al panel de acciones

Para diseñar la interfaz del panel de acciones, agregue un control del panel de acciones al proyecto y, a continuación, agregue controles de formularios Windows Forms al control del panel de acciones.

Para agregar un control del panel de acciones

Seleccione el proyecto Mi panel de acciones básico en el Explorador de soluciones.
En el menú Proyecto, haga clic en Agregar nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, haga clic en Control del panel de acciones, asígnele el nombre InsertTextControl y haga clic en Agregar.

Para agregar controles de formularios Windows Forms al control del panel de acciones

Si el control del panel de acciones no está visible en el diseñador, haga doble clic en InsertTextControl.
En la ficha Controles comunes del Cuadro de herramientas, arrastre un control Label hasta el control del panel de acciones.
Cambie la propiedad Text del control Label a Name.
Agregue un control Textbox al control del panel de acciones y cambie las siguientes propiedades.

Propiedad

Valor

Name

getName

Tamaño

130, 20
Agregue un segundo control Label al control del panel de acciones y cambie la propiedad Text a Address.
Agregue un segundo control Textbox al control del panel de acciones y cambie las siguientes propiedades.

Propiedad

Valor

Name

getAddress

AcceptsReturn

True

Multiline

True

Tamaño

130, 40
Agregue un control Button al control del panel de acciones y cambie las siguientes propiedades.

Propiedad

Valor

Name

addText

Text

Insertar

Propiedad	Valor
Name	getName
Tamaño	130, 20

Propiedad	Valor
Name	getAddress
AcceptsReturn	True
Multiline	True
Tamaño	130, 40

Propiedad	Valor
Name	addText
Text	Insertar

Agregar código al texto Insertar en el documento

En el panel de acciones, escriba código que inserte el texto de los cuadros de texto en los controles Bookmark adecuados del documento. Puede utilizar la clase Globals para tener acceso a los controles del documento desde los controles del panel de acciones. Para obtener más información, vea Acceso global a objetos en los proyectos de Office.

Para insertar texto del panel de acciones en un marcador del documento

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

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

    If Me.getName.Text <> String.Empty Then
        Globals.ThisDocument.showName.Text = Me.getName.Text
    End If

    If Me.getAddress.Text <> String.Empty Then
        Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
    End If

    Me.getName.Text = String.Empty
    Me.getAddress.Text = String.Empty
End Sub

private void addText_Click(object sender, System.EventArgs e)
{
    if (this.getName.Text != String.Empty) 
    {
        Globals.ThisDocument.showName.Text = this.getName.Text;
    }

    if (this.getAddress.Text != String.Empty)
    {
        Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
    }

    this.getName.Text = String.Empty;
    this.getAddress.Text = String.Empty;
}

En C#, debe agregar un controlador de eventos para el clic de botón. Puede colocar este código en el constructor InsertTextControl, después de la llamada a IntializeComponent. Para obtener más información sobre cómo crear controladores de eventos, vea Cómo: Crear controladores de eventos en proyectos de Office.
```
public InsertTextControl()
{
    InitializeComponent();
    this.addText.Click += new EventHandler(addText_Click);
}
```

Agregar código para mostrar el panel de acciones

Para mostrar el panel de acciones, agregue el control que ha creado a la colección de controles.

Para mostrar el panel de acciones

Cree una nueva instancia del control del panel de acciones en la clase ThisDocument.

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

Agregue el código siguiente al controlador de eventos Startup de la clase ThisDocument.
```
Me.ActionsPane.Controls.Add(insertText)
```
```
this.ActionsPane.Controls.Add(insertText);
```

Probar la aplicación

Pruebe el documento para comprobar que el panel de acciones se abre cuando se abre el documento y que el texto escrito en los cuadros de texto se inserta en los marcadores cuando se hace clic en el botón.

Para probar el documento

Presione F5 para ejecutar el proyecto.
Confirme que el panel de acciones está visible.
Escriba su nombre y dirección en los cuadros de texto del panel de acciones y haga clic en Insertar.

Pasos siguientes

Éstas son algunas de las tareas que pueden venir a continuación:

Crear un panel de acciones en Excel. Para obtener más información, vea Cómo: Agregar un recuadro de acciones a un libro de Excel.
Enlazar datos a controles en un panel de acciones. Para obtener más información, vea Tutorial: Enlazar datos a controles en un recuadro de acciones de Word.
Mostrar y ocultar controles en el panel de acciones. Para obtener más información, vea Tutorial: Cambiar el recuadro de acciones de acuerdo con el contexto del usuario.

Vea también