Cómo: Agregar un recuadro de acciones a un documento de Word

Artículo
08/10/2011

Para agregar un panel de acciones a un documento de Microsoft Office Word, primero cree un control de usuario de Windows Forms. A continuación, agregue el control de usuario a la propiedad Controls del campo ThisDocument.ActionsPane del proyecto.

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.

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é usando determinan estos elementos. Para obtener más información, vea Trabajar con valores de configuración.

Crear el control de usuario

El siguiente procedimiento muestra cómo crear un control de usuario en un proyecto de Word. También agrega al control de usuario un botón que escribe texto en el documento cuando se hace clic en él.

Para crear el control de usuario

Abra el documento o proyecto de plantilla de Word en Visual Studio.
En el menú Proyecto, haga clic en Agregar nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, seleccione Control del panel de acciones, denomínelo HelloControl y, a continuación, haga clic en Agregar.

Nota

Alternativamente, puede agregar un elemento Control de usuario a su proyecto. Las clases generadas por los elementos Control del panel de acciones y Control de usuario son equivalentes desde el punto de vista funcional.
En la pestaña Windows Forms del Cuadro de herramientas, arrastre un control Button hasta el control.

Nota

Si el control no está visible en el diseñador, haga doble clic en HelloControl en el Explorador de soluciones.

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

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

    Globals.ThisDocument.Paragraphs(1).Range.Text = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
}

En C#, debe agregar un controlador de eventos para el clic de botón. Puede colocar este código en el constructor HelloControl, después de la llamada a IntializeComponent.

Para obtener información acerca de cómo crear controladores de eventos, vea Cómo: Crear controladores de eventos en proyectos de Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new EventHandler(this.button1_Click);
}
```

Agregar el control de usuario al panel de acciones

Para mostrar el panel de acciones, agregue el control de usuario a la propiedad Controls del campo ThisDocument.ActionsPane.

Para agregar el control de usuario al panel de acciones

Agregue el siguiente código a la clase ThisDocument como una declaración de nivel de clase (no agregue este código a un método).
```
Dim hello As New HelloControl
```
```
private HelloControl hello = new HelloControl();
```
Agregue el código siguiente al controlador de eventos ThisDocument_Startup de la clase ThisDocument.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```