Como: Adicionar um painel de ações para documentos do Word

Artigo
08/08/2011

Para adicionar um painel de ações para um documento do Word 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 ThisDocument.ActionsPane campo em seu projeto.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento para Word 2007 e Word 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.

Creating the User Control

O procedimento a seguir mostra como criar o controle de usuário em um projeto do Word. Ele também adiciona um botão para o controle de usuário que escreve o texto do documento quando ele for clicado.

Para criar o controle de usuário

Abra o seu projeto de modelo ou documento do Word 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 um botão 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.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!";
}

C#, você deve adicionar um manipulador para o clique do botão. Você pode colocar esse código de HelloControl construtor após a chamada para 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 para o painel de ações

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

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

Adicione o seguinte código para o ThisDocument 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 ThisDocument_Startup o manipulador de eventos da ThisDocument classe.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```