Cómo: Agregar un panel de acciones a documentos de Word o libros de Excel

Artículo
02/19/2013

Para agregar un panel de acciones a un documento de Microsoft Office Word o un libro de Microsoft Excel, primero cree un control de usuario de formularios Windows Forms.A continuación, agregue el control de usuario a la propiedad Controls de campo ThisDocument.ActionsPane (palabra) o campo ThisWorkbook.ActionsPane (Excel) en el proyecto.

Se aplica a: La información de este tema se aplica a los proyectos de nivel de documento para las siguientes aplicaciones: Excel 2013 y Excel 2010; Word 2013 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 Valores de configuración de Visual Studio.

Crear el control de usuario

El siguiente procedimiento muestra cómo crear un control de usuario en un proyecto de word o excel.También agrega al control de usuario un botón que escribe texto en el documento o el libro cuando se haga clic en.

Para crear el control de usuario

Abra el proyecto de nivel de documento de word o de Excel 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 código al controlador de eventos Click del botón.El ejemplo siguiente se muestra el código para un documento de Microsoft Office Word.

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 de campo ThisDocument.ActionsPane (palabra) o campo ThisWorkbook.ActionsPane (Excel).

Para agregar el control de usuario al panel de acciones

Agregue el código siguiente a la clase ThisDocument o ThisWorkbook 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 o al controlador de eventos ThisWorkbook_Startup de la clase ThisWorkbook .
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```