Passo a passo: associar dados a controles em um painel de ações do Word

Importante

O recurso Ações foi desativado no Office 2024.

Esse recurso só está disponível nas seguintes versões do Office:

• Microsoft 365
• Office LTSC Professional Plus 2021
• Office LTSC Standard 2021
• Office Professional Plus 2016, 2019
• Office Standard 2016, 2019

Este passo a passo demonstra a associação de dados aos controles em um painel de ações no Word. Os controles demonstram uma relação mestre/detalhe entre tabelas em um banco de dados do SQL Server.

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

Este passo a passo ilustra as seguintes tarefas:

• Criando um painel de ações com controles do Windows Forms associados a dados.

• Usando uma relação mestre/detalhe para exibir dados nos controles.

• Mostrar o painel ações quando o aplicativo for aberto.

Observação

Seu computador pode mostrar nomes ou locais diferentes 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ê tem e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizar o IDE do Visual Studio.

Pré-requisitos

Você precisa dos seguintes componentes para concluir este passo a passo:

• Uma edição do Visual Studio que inclui as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte Configurar um computador para desenvolver soluções do Office.

• Word 2013 ou Word 2010 .

• Acesso a um servidor com o banco de dados de exemplo do Northwind SQL Server.

• Permissões para ler e gravar no banco de dados do SQL Server.

Criar o projeto

A primeira etapa é criar um projeto do Documento do Word.

Para criar um novo projeto

1. Crie um projeto do Documento do Word com o nome Painel de Ações do Meu Word. Nesse assistente, selecione Criar um documento.

   Para obter mais informações, consulte Como criar projetos do Office no Visual Studio.

   O Visual Studio abre o novo documento do Word no designer e adiciona o projeto Painel Minhas Ações do Word ao Gerenciador de Soluções.

Adicionar controles ao painel ações

Para este passo a passo, você precisa de um controle de painel de ações que contenha controles do Windows Forms associados a dados. Adicione uma fonte de dados ao projeto e arraste os controles da janela Fontes de Dados para o controle do painel de ações.

Para adicionar um controle de painel de ações

1. Selecione o projeto painel Minhas Ações do Word no Gerenciador de Soluções.

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

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

Para adicionar uma fonte de dados ao projeto

1. Se a janela Fontes de Dados não estiver visível, exiba-a na barra de menus, escolhendo Exibir>Outras janelas>Fontes de dados.

   Observação

   Se mostrar fontes de dados não estiver disponível, clique no documento do Word e verifique novamente.

2. Clique em Adicionar nova fonte de dados para iniciar o assistente de configuração da fonte de dados .

3. Selecione Banco de dados e clique em Avançar.

4. Selecione uma conexão de dados com o banco de dados de exemplo do SQL Server Northwind, ou adicione uma nova conexão usando o botão Nova Conexão.

5. Clique em Próximo.

6. Desmarque a opção para salvar a conexão se ela estiver selecionada e clique em Avançar.

7. Expanda o nó Tabelas na janela Objetos do banco de dados.

8. Marque a caixa de seleção ao lado das tabelas Fornecedores e Produtos.

9. Clique em Concluir.

   O assistente adiciona a tabela Fornecedores e a tabela Produtos à janela Fontes de dados. Ele também adiciona um conjunto de dados tipificado ao seu projeto que está visível no Gerenciador de Soluções.

Para adicionar controles do Windows Forms associados a dados a um controle de painel de ações

1. Na janela de Fontes de Dados , expanda a tabela Fornecedores.

2. Clique na seta suspensa do nó Nome da Empresa e selecione ComboBox.

3. Arraste CompanyName da janela Fontes de Dados para o controle do Painel de Ações.

   Um controle ComboBox é criado no painel de controle de ações. Ao mesmo tempo, um BindingSource chamado SuppliersBindingSource, um adaptador de tabela e um DataSet são adicionados ao projeto na bandeja de componentes.

4. Selecione SuppliersBindingNavigator na bandeja de Componentes e pressione Excluir. Você não usará o SuppliersBindingNavigator neste passo a passo.

   Observação

   Excluir o SuppliersBindingNavigator não remove todo o código que foi gerado para ele. Você pode remover esse código.

5. Mova a caixa de combinação para que ela ficar embaixo do rótulo e altere a propriedade Tamanho para 171, 21.

6. Na janela de Fontes de Dados, expanda a tabela Produtos que é uma tabela filha da tabela Fornecedores.

7. Clique na seta suspensa no nó ProductName e selecione ListBox.

8. Arraste ProductName para o controle do painel de ações.

   Um controle ListBox é criado no controle do painel de ações. Ao mesmo tempo, um BindingSource chamado ProductBindingSource e um adaptador de tabela são adicionados ao projeto na bandeja de componentes.

9. Mova a caixa de listagem para que ela ficar embaixo do rótulo e altere a propriedade Tamanho para 171,95.

10. Arraste um Button da Caixa de ferramentas para o controle do painel de ações e coloque-o abaixo da caixa de listagem.

11. Clique com o botão direito do mouse no Button, clique em Propriedades no menu de atalho e altere as propriedades a seguir.

    Propriedade	Valor
    Nome	inserir
    Text	inserir

12. Redimensione o controle do usuário para ajustar os controles.

Configurar a fonte de dados

Para configurar a fonte de dados, adicione código ao evento Load do controle do painel de ações para preencher o controle com dados do DataTablee defina as propriedades DataSource e DataMember para cada controle.

Para carregar o controle com dados

1. No manipulador de eventos Load da classe ActionsControl, adicione o código a seguir.

   C#

   private void ActionsControl_Load(object sender, EventArgs e)
   {
       this.suppliersTableAdapter.Fill(this.northwindDataSet.Suppliers);
       this.productsTableAdapter.Fill(this.northwindDataSet.Products);
   }
   

   VB

   Private Sub ActionsControl_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles Me.Load
   
       Me.SuppliersTableAdapter.Fill(Me.NorthwindDataSet.Suppliers)
       Me.ProductsTableAdapter.Fill(Me.NorthwindDataSet.Products)
   End Sub
   

2. No C#, você deve anexar o manipulador de eventos ao evento Load. Você pode colocar esse código no construtor ActionsControl, após a chamada para InitializeComponent. Para obter mais informações sobre como criar manipuladores de eventos, consulte Como criar manipuladores de eventos em projetos do Office.

   this.Load += new EventHandler(ActionsControl_Load);
   

Para definir as propriedades de associação de dados dos controles

1. Selecione o controle CompanyNameComboBox.

2. Na janela Propriedades, clique no botão à direita da propriedade DataSource e selecione suppliersBindingSource.

3. Clique no botão à direita da propriedade DisplayMember e selecione CompanyName.

4. Expanda a propriedade DataBindings, clique no botão à direita da propriedade Texto e selecione Nenhum.

5. Selecione o controle ProductNameListBox.

6. Na janela Propriedades, clique no botão à direita da propriedade DataSource e selecione productsBindingSource.

7. Clique no botão à direita da propriedade DisplayMember e selecione ProductName.

8. Expanda a propriedade DataBindings, clique no botão à direita da propriedade SelectedValue e selecione Nenhum.

Adicionar um método para inserir dados em uma tabela

A próxima tarefa é ler os dados dos controles associados e preencher uma tabela no documento do Word. Primeiro, crie um procedimento para formatar os títulos na tabela e adicione o método AddData para criar e formatar uma tabela do Word.

Para formatar os títulos da tabela

1. Na classe ActionsControl, crie um método para formatar os títulos da tabela.

   C#

   static void SetHeadings(Microsoft.Office.Interop.Word.Cell tblCell, string text)
   {
       tblCell.Range.Text = text;
       tblCell.Range.Font.Bold = 1;
       tblCell.Range.ParagraphFormat.Alignment = 
           Microsoft.Office.Interop.Word.WdParagraphAlignment.wdAlignParagraphCenter;
   }
   

   VB

   Shared Sub SetHeadings(ByVal tblCell As Word.Cell, ByVal text As String)
   
       With tblCell.Range
           .Text = text
           .Font.Bold = True
           .ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter
       End With
   End Sub
   

Para criar a tabela

1. Na classe ActionsControl, escreva um método que criará uma tabela se ainda não existir e adicione dados do painel ações à tabela.

   C#

   private void AddData(System.Data.DataRow row, string companyName)
   {
       object missing = System.Type.Missing;
   
       // Create a table if it doesn't already exist.
       if (Globals.ThisDocument.Tables.Count == 0)
       {
           try
           {
               // Create a table.
               Microsoft.Office.Interop.Word.Table tbl = Globals.ThisDocument.Tables.Add
                   (Globals.ThisDocument.Application.Selection.Range, 1, 4, ref missing, ref missing);
   
               // Insert headings.
               SetHeadings(tbl.Cell(1, 1), "Company Name");
               SetHeadings(tbl.Cell(1, 2), "Product Name");
               SetHeadings(tbl.Cell(1, 3), "Quantity");
               SetHeadings(tbl.Cell(1, 4), "Unit Price");
           }
           catch (Exception ex)
           {
               MessageBox.Show("Problem creating Products table: " + ex.Message, 
                   "Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error);
           }
       }
   
       // Add data from data row to the table.
       Microsoft.Office.Interop.Word.Selection selection = Globals.ThisDocument.Application.Selection;
   
       if (selection.Tables.Count > 0)
       {
           Microsoft.Office.Interop.Word.Row newRow = Globals.ThisDocument.Tables[1].Rows.Add(ref missing);
   
           newRow.Range.Font.Bold = 0;
   
           newRow.Range.ParagraphFormat.Alignment = 
               Microsoft.Office.Interop.Word.WdParagraphAlignment.wdAlignParagraphLeft;
   
           newRow.Cells[4].Range.ParagraphFormat.Alignment =
               Microsoft.Office.Interop.Word.WdParagraphAlignment.wdAlignParagraphRight;
   
           newRow.Cells[1].Range.Text = companyName;
           newRow.Cells[2].Range.Text = row["ProductName"].ToString();
           newRow.Cells[3].Range.Text = row["QuantityPerUnit"].ToString();
           newRow.Cells[4].Range.Text = Math.Round(Convert.ToDouble(row["UnitPrice"])).ToString("#,##0.00");
       }
       else
       {
           MessageBox.Show("Cursor must be within a table.", 
               "Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error);
       }
   }
   

   VB

   Private Sub AddData(ByVal row As System.Data.DataRow, ByVal companyName As String)
   
       ' Create a table if it doesn't already exist.
       If Globals.ThisDocument.Tables.Count = 0 Then
   
           Try
               ' Create a table. 
               Dim tbl As Word.Table = Globals.ThisDocument.Tables.Add( _
                   Globals.ThisDocument.Application.Selection.Range, 1, 4)
   
               ' Insert headings.
               SetHeadings(tbl.Cell(1, 1), "Company Name")
               SetHeadings(tbl.Cell(1, 2), "Product Name")
               SetHeadings(tbl.Cell(1, 3), "Quantity")
               SetHeadings(tbl.Cell(1, 4), "Unit Price")
   
           Catch ex As Exception
               MessageBox.Show("Problem creating Products table: " & ex.Message, _
                   "Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error)
           End Try
       End If
   
       ' Add data from data row to the table.
       Dim selection As Word.Selection = Globals.ThisDocument.Application.Selection
   
       If selection.Tables.Count > 0 Then
   
           Dim newRow As Word.Row = Globals.ThisDocument.Tables(1).Rows.Add()
           With newRow
               .Range.Font.Bold = False
               .Range.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphLeft
               .Cells(4).Range.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphRight
               .Cells(1).Range.Text = companyName
               .Cells(2).Range.Text = row.Item("ProductName").ToString
               .Cells(3).Range.Text = row.Item("QuantityPerUnit").ToString
               .Cells(4).Range.Text = Math.Round(row.Item("UnitPrice"), 2)
           End With
   
       Else
           MessageBox.Show("Cursor must be within a table.", _
               "Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error)
       End If
   End Sub
   

Para inserir texto em uma tabela do Word

1. Adicione o código a seguir ao manipulador de eventos Click do botão Inserir.

   C#

   private void Insert_Click(object sender, System.EventArgs e)
   {
       System.Data.DataTable tbl = northwindDataSet.Products;
       System.Data.DataRow[] rows;
   
       // Check if a product is selected.
       if (this.productNameListBox.SelectedIndex >= 0)
       {
           System.Data.DataRowView productRow = (System.Data.DataRowView)this.productNameListBox.SelectedItem;
   
           string product = productRow.Row["ProductName"].ToString();
           string company = this.companyNameComboBox.Text;
   
           // Return the data row from the selected product.
           rows = tbl.Select("[ProductName] = '" + product.Replace("'", "''") + "'");
   
           this.AddData(rows[0], company);
       }
       else
       {
           MessageBox.Show("Please select a product.", "Actions Pane", MessageBoxButtons.OK);
       }
   }
   

   VB

   Private Sub Insert_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Insert.Click
   
       Dim tbl As System.Data.DataTable = NorthwindDataSet.Products
       Dim rows() As System.Data.DataRow
   
       ' Check if a product is selected.
       If Not Me.ProductNameListBox.SelectedIndex < 0 Then
   
           Dim product As String = Me.ProductNameListBox.SelectedItem.Row.Item("ProductName")
           Dim company As String = Me.CompanyNameComboBox.Text
   
           ' Return the data row from the selected Product in the list box.
           rows = tbl.Select("[ProductName] = '" & product.Replace("'", "''") & "'")
   
           AddData(rows(0), company)
   
       Else
           MessageBox.Show("Please select a product.", "Actions Pane", MessageBoxButtons.OK)
       End If
   End Sub
   

2. No C#, você deve criar um manipulador de eventos para o evento Click do botão. Você pode colocar esse código no manipulador de eventos Load da classe ActionsControl.

   this.Insert.Click += new EventHandler(Insert_Click);
   

Mostrar o painel ações

O painel ações fica visível depois que os controles são adicionados a ele.

Para mostrar o painel ações

1. No do Gerenciador de Soluções, clique com o botão direito do mouse em ThisDocument.vb ou ThisDocument.cse clique em Exibir Código no menu de atalho.

2. Crie uma nova instância do controle na parte superior da classe ThisDocument para que ele se pareça com o exemplo a seguir.

   C#

   private ActionsControl actions = new ActionsControl();
   

   VB

   Dim actions As New ActionsControl
   

3. Adicione código ao manipulador de eventos Startup de ThisDocument para que ele se pareça com o exemplo a seguir.

   C#

   this.ActionsPane.Controls.Add(actions);
   

   VB

   Me.ActionsPane.Controls.Add(actions)
   

Testar o aplicativo

Agora você pode testar seu documento para verificar se o painel de ações aparece quando o documento é aberto. Teste a relação mestre/detalhe nos controles no painel de ações e verifique que os dados são preenchidos em uma tabela do Word quando o botão Inserir for clicado.

Para testar seu documento

1. Pressione F5 para executar o projeto.

2. Confirme se o painel ações está visível.

3. Selecione uma empresa na caixa de combinação e verifique se os itens na caixa de listagem Produtos mudam.

4. Selecione um produto, clique em Inserir no painel ações e verifique se os detalhes do produto foram adicionados à tabela no Word.

5. Insira produtos adicionais de várias empresas.

Próximas etapas

Este passo a passo mostra as noções básicas de associação de dados a controles em um painel de ações no Word. Aqui estão algumas tarefas que podem vir a seguir:

• Associando dados a controles no Excel. Para obter mais informações, consulte Passo a passo: associar dados a controles em um painel de ações do Excel.

• Implantando o projeto. Para obter mais informações, consulte Implantar uma solução do Office usando o ClickOnce.

Conteúdo relacionado

• Visão geral do painel de ações
• Como adicionar um painel de ações a documentos do Word ou pastas de trabalho do Excel
• Associar dados a controles em soluções do Office