Como: Adicionar um painel de ações para pastas de trabalho do Excel

Artigo
08/08/2011

Para adicionar um painel de ações para uma pasta de trabalho do Excel de Microsoft Office, primeiro crie um controle de usuário do Windows Forms. Em seguida, adicione o controle de usuário para o Controls propriedade da ThisWorkbook.ActionsPane campo em seu projeto.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento para Excel 2007 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Observação
Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Trabalhando com configurações.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Fazer como i: Usar os controles do WPF dentro de um painel de ações do Excel?.

Creating the User Control

O procedimento a seguir mostra como criar um controle de usuário em um projeto do Excel. Ele também adiciona um botão para o controle de usuário que grava o texto em uma célula da planilha quando é clicado.

Para criar o controle de usuário

Abra o seu projeto de modelo ou a pasta de trabalho do Excel no Visual Studio.
On the Project menu, click Add New Item.

No Add New Item caixa de diálogo, selecione Controle de painel de ações, o nome HelloControle clique em Add.

Observação
Como alternativa, você pode adicionar um O controle de usuário item ao seu projeto. As classes geradas pela Controle de painel de ações e O controle de usuário itens são funcionalmente equivalentes.

Do Windows Forms guia da Toolbox, arrastar uma botão controle para o controle.

Observação

Se o controle não estiver visível no designer, clique duas vezes em HelloControl na Solution Explorer.

Observação
Se o controle não estiver visível no designer, clique duas vezes em HelloControl na Solution Explorer.

Adicione o seguinte código para o Click o manipulador de eventos do botão.

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!";
}

No C#, você deve criar um manipulador de eventos para o Button. Você pode colocar esse código de HelloControl construtor. For more information about creating event handlers, see Como: Criar manipuladores de eventos em projetos do Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new System.EventHandler(this.button1_Click);
}
```

Adicionando o controle de usuário para o painel de ações

Para mostrar o painel de ações, adicione o controle do usuário para o Controls propriedade da ThisWorkbook.ActionsPane campo.

Para adicionar o controle de usuário para o painel de ações

Adicione o seguinte código para o ThisWorkbook classe como uma declaração de nível de classe (não adicione esse código para um método).
```
Dim hello As New HelloControl
```
```
private HelloControl hello = new HelloControl();
```
Adicione o seguinte código para o ThisWorkbook_Startup o manipulador de eventos da ThisWorkbook classe.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```