Cómo: Agregar un recuadro de acciones a un libro de Excel

Artículo
08/10/2011

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

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento para Excel 2007 y Excel 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.

vínculo a vídeo Dispone de una demostración en vídeo en How Do I: Use WPF Controls Inside an Excel Actions Pane?.

Crear el control de usuario

El siguiente procedimiento muestra cómo crear un control de usuario en un proyecto de Excel. También agrega al control de usuario un botón que escribe texto en una celda de la hoja de cálculo cuando se hace clic en él.

Para crear el control de usuario

Abra el proyecto de libro o de plantilla 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 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.Sheet1.Range("A1").Value2 = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.Sheet1.Range["A1", System.Type.Missing].Value2 = "Hello World!";
}

En C#, debe crear un controlador de eventos para Button. Puede colocar este código en el constructor HelloControl. Para obtener información sobre cómo crear controladores de eventos, vea Cómo: Crear controladores de eventos en proyectos de Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new System.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 ThisWorkbook.ActionsPane.

Para agregar el control de usuario al panel de acciones

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