Adicionar um painel de ações a documentos do Word ou pastas de trabalho do Excel

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

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel e Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Observação

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

Criando o controle de usuário

O procedimento a seguir mostra como criar controle de usuário em um projeto do Word ou Excel. Ele também adiciona um botão ao controle de usuário que grava texto no documento ou pasta de trabalho quando ele é clicado.

Para criar o controle de usuário

1. Abra seu projeto de nível de documento do Word ou Excel no Visual Studio.

2. No menu Projeto , clique em Adicionar Novo Item.

3. Na caixa de diálogo Adicionar Novo Item, selecione Controle do Painel de Ações, nomeie-o como HelloControl e clique em Adicionar.

   Observação

   Como alternativa, você pode adicionar um item de Controle de Usuário ao seu projeto. As classes geradas pelos itens Controle do Painel de Ações e Controle de Usuário são funcionalmente equivalentes.

4. Na guia Windows Forms da caixa de ferramentas, arraste um controle Button para o controle.

   Observação

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

5. Adicione o código ao Click manipulador de eventos do botão. O exemplo a seguir mostra o código de um documento do Microsoft Office Word.

   C#

   private void button1_Click(object sender, System.EventArgs e)
   {
       Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
   }
   

   VB

   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
   

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

   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);
   }
   

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

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

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

1. Adicione o código a seguir à ThisDocument classe ou como uma declaração de nível de classe (não adicione esse código a ThisWorkbook um método).

   C#

   private HelloControl hello = new HelloControl();
   

   VB

   Dim hello As New HelloControl
   

2. Adicione o código a seguir ao manipulador de eventos da classe ou ao ThisDocument_Startup ThisWorkbook_Startup manipulador de eventos da ThisWorkbook ThisDocument classe.

   C#

   this.ActionsPane.Controls.Add(hello);
   

   VB

   Me.ActionsPane.Controls.Add(hello)
   

Conteúdo relacionado

• Visão geral do painel de ações
• Demonstra Passo a passo: inserir texto num documento a partir de um painel de ações
• Como gerenciar o layout de controle em painéis de ações
• Demonstra Passo a passo: inserir texto num documento a partir de um painel de ações