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

Artículo
04/28/2010

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, vea Características disponibles por aplicación y tipo de proyecto.

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, vea Características disponibles por aplicación y tipo de proyecto.

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.

Este tutorial ilustra 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 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.

Visual Studio Tools para Office se instala, de forma predeterminada, con las versiones que se enumeran de Visual Studio. Para comprobar si está instalado, consulte Instalar Visual Studio Tools para Office.

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 Visual Studio para Office.

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.
Siga uno de estos procedimientos:
- En Word 2003: En el menú Insertar, haga clic en Marcador.
- En Word 2007: En la ficha 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

Size

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

Size

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

Propiedad

Valor

Name

addText

Text

Insert

Propiedad	Valor
Name	getName
Size	130, 20

Propiedad	Valor
Name	getAddress
AcceptsReturn	True
Multiline	True
Size	130, 40

Propiedad	Valor
Name	addText
Text	Insert

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 proyectos de Visual Studio Tools para 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 Visual Studio Tools para 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.