Como: adiciona um painel de ações para documentos do Word ou planilhas do Excel

Artigo
02/25/2013

Para adicionar um painel de ações a um documento Microsoft Office Word ou a uma pasta de trabalho do Microsoft Excel, primeiro crie um controle de usuário formulários do windows.Em seguida, adicione o controle de usuário à propriedade de Controls do campo de ThisDocument.ActionsPane palavra () ou do campo de ThisWorkbook.ActionsPane Excel () no seu projeto.

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

Observação
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário Visual Studio nas instruções a seguir.A edição Visual Studio que você possui e as configurações que você usa determinam esses elementos.Para obter mais informações, consulte Configurações de Visual Studio.

Criando o Controle do Usuário

O procedimento a seguir mostra como criar o controle de usuário em um projeto do word ou Excel.Também adicionará um botão ao controle de usuário que grava texto ao documento ou pasta de trabalho quando é clicado.

Para criar o controle de usuário

Abra seu projeto de um documento do word ou nível do excel no Visual Studio.
No menu Project, clique em Add New Item.

Em a caixa de diálogo de Adicionar novo item , Controle do Painel Açõesselecione, nomeia-a HelloControl, clique Adicionar.

Observação
Você também pode adicionar um item de Controle do Usuário ao seu projeto.As classes geradas pelos itens de Controle do Painel Ações e de Controle do Usuário são funcionalmente equivalentes.

De a guia de Windows Forms de arrasto de A caixa de ferramentas, um controle de Botão no controle.

Observação

Se o controle não estiver visível no designer, clique duas vezes em HelloControl em Gerenciador de Soluções.

Observação
Se o controle não estiver visível no designer, clique duas vezes em HelloControl em Gerenciador de Soluções.

Adicione código ao manipulador de eventos de Click do botão.O código a seguir mostra um exemplo de um documento 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!";
}

Em C#, você deve adicionar um manipulador de eventos do clique de botão.Você pode colocar esse código no construtor de HelloControl após a chamada a IntializeComponent.

Para obter informações sobre como criar manipuladores de eventos, consulte Como: criar manipuladores de eventos em projetos do Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new EventHandler(this.button1_Click);
}
```

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

Para mostrar o painel de ações, adicione o controle de usuário à propriedade de Controls do campo de ThisDocument.ActionsPane palavra () ou do campo de ThisWorkbook.ActionsPane Excel ().

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

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