Instruções passo a passo: atualizando um gráfico em uma planilha usando botões de opção

Este passo a passo mostra as noções básicas do uso de botões de opção em uma planilha do Microsoft Office Excel para dar ao usuário uma maneira de alternar rapidamente entre as opções. Nesse caso, as opções alteram o estilo de um gráfico.

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

Para ver o resultado como um exemplo concluído, consulte o Exemplo de controles do Excel em Exemplos de desenvolvimento e instruções passo a passo do Office.

Este passo a passo ilustra as seguintes tarefas:

• Adicionar um grupo de botões de opção a uma planilha.

• Alterando o estilo do gráfico quando uma opção ser selecionada.

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.

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

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

• Excel 2013 ou Excel 2010 .

Adicionar um gráfico a uma planilha

Você pode criar um projeto de pasta de trabalho do Excel que personaliza uma pasta de trabalho existente. Nesta explicação passo a passo, você adicionará um gráfico a uma pasta de trabalho e, em seguida, usará essa pasta de trabalho em uma nova solução do Excel. A fonte de dados neste passo a passo é uma planilha chamada Dados para Gráfico.

Para adicionar os dados

1. Abra o Microsoft Excel.

2. Clique com o botão direito do mouse na guia Sheet3 e, em seguida, clique em Renomear no menu de atalho.

3. Renomeie a planilha para Dados para Gráfico.

4. Adicione os seguintes dados a Dados para Gráfico com a célula A4 sendo o canto superior esquerdo e E8 o canto inferior direito.

   Região / Bairro	Q1	Q2	T3	T4
   Oeste	500	550	550	600
   Leste	600	625	675	700
   Norte	450	470	490	510
   Sul	800	750	775	790

   Em seguida, adicione um gráfico à primeira planilha para exibir os dados.

Para adicionar um gráfico no Excel

1. No separador Inserir, no grupo Gráficos, clique em Coluna e, em seguida, clique em Todos os Tipos de Gráfico.

2. Na caixa de diálogo Inserir Gráfico, clique em OK.

3. Na guia Design, no grupo Dados, clique em Selecionar Dados.

4. Na caixa de diálogo Selecionar Fonte de Dados, clique na caixa Intervalo de dados do gráfico e desmarque qualquer seleção padrão.

5. Na folha Dados para Gráfico, selecione o bloco de células que contém os números, que inclui A4 no canto superior esquerdo a E8 no canto inferior direito.

6. Na caixa de diálogo Selecionar Fonte de Dados, clique em OK.

7. Reposicione o gráfico para que o canto superior direito se alinhe com a célula E2.

8. Salve seu arquivo na unidade C e nomeie-o ExcelChart.xlsx.

9. Saia do Excel.

Crie um novo projeto

Nesta etapa, você criará um projeto de pasta de trabalho do Excel com base na pasta de trabalho ExcelChart .

Criar um novo projeto

1. Crie um projeto de pasta de trabalho do Excel com o nome Meu gráfico do Excel. No assistente, selecione Copiar um documento existente.

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

2. Clique no botão Procurar e navegue até a pasta de trabalho criada anteriormente nesta explicação passo a passo.

3. Clique em OK.

   O Visual Studio abre a nova pasta de trabalho do Excel no designer e adiciona o projeto Meu gráfico do Excel ao Gerenciador de Soluções.

Definir propriedades do gráfico

Quando você cria um novo projeto de pasta de trabalho do Excel que usa uma pasta de trabalho existente, controles de host são criados automaticamente para todos os intervalos nomeados, objetos de lista e gráficos na pasta de trabalho. Você pode alterar o Chart nome do controle usando a janela Propriedades .

Para alterar o nome do controle Chart

1. Selecione o Chart controle no designer e altere as seguintes propriedades na janela Propriedades .

   Propriedade	Valor
   Nome	dataGráfico
   HasLegend	false

Adicionar controles

Esta planilha usa botões de opção para oferecer aos usuários uma maneira de alterar rapidamente o estilo do gráfico. No entanto, os botões de opção precisam ser exclusivos — quando um botão é selecionado, nenhum outro botão do grupo pode ser selecionado ao mesmo tempo. Esse comportamento não acontece por padrão quando você adiciona vários botões de opção a uma planilha.

Uma maneira de adicionar esse comportamento é agrupar os botões de opção em um controle de usuário, escrever seu código por trás do controle de usuário e, em seguida, adicionar o controle de usuário à planilha.

Para adicionar um controle de usuário

1. Selecione o projeto Meu Gráfico do Excel no Gerenciador de Soluções.

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

3. Na caixa de diálogo Adicionar Novo Item, clique em Controle de Usuário, nomeie o controle como ChartOptions e clique em Adicionar.

Para adicionar botões de opção ao controle de usuário

1. Se o controle de usuário não estiver visível no designer, clique duas vezes em ChartOptions no Gerenciador de Soluções.

2. Na guia Controles comuns da caixa de ferramentas, arraste um controle de botão de opção para o controle de usuário e altere as propriedades a seguir.

   Propriedade	Valor
   Nome	columnChart
   Texto	Gráfico de colunas

3. Adicione um segundo botão de opção ao controle de usuário e altere as propriedades a seguir.

   Propriedade	Valor
   Nome	Gráfico de barras
   Texto	Gráfico de Barras

4. Adicione um terceiro botão de opção ao controle de usuário e altere as propriedades a seguir.

   Propriedade	Valor
   Nome	lineChart
   Texto	Gráfico de linhas

5. Adicione um quarto botão de opção ao controle de usuário e altere as propriedades a seguir.

   Propriedade	Valor
   Nome	areaBlockChart
   Texto	Gráfico de Blocos de Área

   Em seguida, escreva o código para atualizar o gráfico quando um botão de opção for clicado.

Alterar o estilo do gráfico quando um botão de opção é selecionado

Agora você pode adicionar o código para alterar o estilo do gráfico. Para fazer isso, crie um evento público no controle de usuário, adicione uma propriedade para definir o tipo de seleção e crie um manipulador de eventos para o CheckedChanged evento de cada um dos botões de opção.

Para criar um evento e uma propriedade em um controle de usuário

1. No Gerenciador de Soluções, clique com o botão direito do mouse no controle de usuário e clique em Exibir Código.

2. Adicione código à ChartOptions classe para criar um SelectionChanged evento e a Selection propriedade.

   C#

   public event EventHandler SelectionChanged;
   
   private Microsoft.Office.Interop.Excel.XlChartType selectedType =
       Microsoft.Office.Interop.Excel.XlChartType.xlColumnClustered;
   
   public Microsoft.Office.Interop.Excel.XlChartType Selection
   {
       get
       {
           return this.selectedType;
       }
       set
       {
           this.selectedType = value;
       }
   }
   

   VB

   Public Event SelectionChanged(ByVal sender As System.Object, ByVal e As System.EventArgs)
   
   Private selectedType As Microsoft.Office.Interop.Excel.XlChartType = _
       Microsoft.Office.Interop.Excel.XlChartType.xlColumnClustered
   
   Public Property Selection() As Microsoft.Office.Interop.Excel.XlChartType
       Get
           Return Me.selectedType
       End Get
       Set(ByVal value As Microsoft.Office.Interop.Excel.XlChartType)
           Me.selectedType = value
       End Set
   End Property
   

Para manipular o evento CheckedChanged dos botões de opção

1. Defina o tipo de gráfico no manipulador de eventos CheckedChanged do botão de opção areaBlockChart e, em seguida, gere o evento.

   C#

   private void areaBlockChart_CheckedChanged(object sender, EventArgs e)
   {
       if (((RadioButton)sender).Checked)
       {
           this.selectedType = Microsoft.Office.Interop.Excel.XlChartType.xlAreaStacked;
           if (this.SelectionChanged != null)
           {
               this.SelectionChanged(this, EventArgs.Empty);
           }
       }
   }
   

   VB

   Private Sub areaBlockChart_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles areaBlockChart.CheckedChanged
   
       If (CType(sender, RadioButton).Checked) Then
   
           Me.selectedType = Microsoft.Office.Interop.Excel.XlChartType.xlAreaStacked
           RaiseEvent SelectionChanged(Me, EventArgs.Empty)
       End If
   End Sub
   

2. Defina o tipo de gráfico no manipulador de eventos CheckedChanged do botão de opção barChart.

   C#

   private void barChart_CheckedChanged(object sender, EventArgs e)
   {
       if (((RadioButton)sender).Checked)
       {
           this.selectedType = Microsoft.Office.Interop.Excel.XlChartType.xlBarClustered;
           if (this.SelectionChanged != null)
           {
               this.SelectionChanged(this, EventArgs.Empty);
           }
       }
   }
   

   VB

   Private Sub barChart_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles barChart.CheckedChanged
   
       If (CType(sender, RadioButton).Checked) Then
   
           Me.selectedType = Microsoft.Office.Interop.Excel.XlChartType.xlBarClustered
           RaiseEvent SelectionChanged(Me, EventArgs.Empty)
       End If
   End Sub
   

3. Defina o tipo de gráfico no manipulador de eventos CheckedChanged do botão de opção columnChart.

   C#

   private void columnChart_CheckedChanged(object sender, EventArgs e)
   {
       if (((RadioButton)sender).Checked)
       {
           this.selectedType = Microsoft.Office.Interop.Excel.XlChartType.xlColumnClustered;
           if (this.SelectionChanged != null)
           {
               this.SelectionChanged(this, EventArgs.Empty);
           }
       }
   }
   

   VB

   Private Sub columnChart_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles columnChart.CheckedChanged
   
       If (CType(sender, RadioButton).Checked) Then
   
           Me.selectedType = Microsoft.Office.Interop.Excel.XlChartType.xlColumnClustered
           RaiseEvent SelectionChanged(Me, EventArgs.Empty)
       End If
   End Sub
   

4. Defina o tipo de gráfico no manipulador de eventos CheckedChanged do botão de opção lineChart.

   C#

   private void lineChart_CheckedChanged(object sender, EventArgs e)
   {
       if (((RadioButton)sender).Checked)
       {
           this.selectedType = Microsoft.Office.Interop.Excel.XlChartType.xlLineMarkers;
           if (this.SelectionChanged != null)
           {
               this.SelectionChanged(this, EventArgs.Empty);
           }
       }
   }
   

   VB

   Private Sub lineChart_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles lineChart.CheckedChanged
   
       If (CType(sender, RadioButton).Checked) Then
   
           Me.selectedType = Microsoft.Office.Interop.Excel.XlChartType.xlLineMarkers
           RaiseEvent SelectionChanged(Me, EventArgs.Empty)
       End If
   End Sub
   

5. No C#, é necessário adicionar manipuladores de eventos aos botões de opção. É possível adicionar o código ao construtor ChartOptions, abaixo da chamada para InitializeComponent. Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos em projetos do Office.

   public ChartOptions()
   {
       InitializeComponent();
   
       areaBlockChart.CheckedChanged += new EventHandler(areaBlockChart_CheckedChanged);
       barChart.CheckedChanged += new EventHandler(barChart_CheckedChanged);
       columnChart.CheckedChanged += new EventHandler(columnChart_CheckedChanged);
       lineChart.CheckedChanged += new EventHandler(lineChart_CheckedChanged);
   }
   

Adicionar o controle de usuário à planilha

Quando você cria a solução, o novo controle de usuário é adicionado automaticamente à Caixa de Ferramentas. Em seguida, você pode arrastar o controle da caixa de ferramentas para sua planilha.

Para adicionar o controle de usuário à sua planilha

1. No menu Compilar, clique em Compilar Solução.

   O controle de usuário ChartOptions é adicionado à caixa de ferramentas.

2. No Gerenciador de Soluções, clique com o botão direito do mouse em Sheet1.vb ou Sheet1.cs e clique em Exibir Designer.

3. Arraste o controle ChartOptions da caixa de ferramentas para a planilha.

   Um novo controle chamado my_Excel_Chart_ChartOptions1 é adicionado ao seu projeto.

4. Altere o nome do controle para ChartOptions1.

Alterar o tipo de gráfico

Para alterar o tipo de gráfico, crie um manipulador de eventos que defina o estilo de acordo com a opção selecionada no controle de usuário.

Para alterar o tipo de gráfico exibido na planilha

1. Adicione o manipulador de eventos a seguir à classe Sheet1.

   C#

   private void ChartOptions1_SelectionChanged(object sender, EventArgs e)
   {
       try
       {
           dataChart.ChartType = this.ChartOptions1.Selection;
       }
       catch (Exception ex)
       {
           MessageBox.Show(ex.ToString());
       }
   }
   

   VB

   Private Sub ChartOptions1_SelectionChanged(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles ChartOptions1.SelectionChanged
   
       Try
           dataChart.ChartType = Me.ChartOptions1.Selection
       Catch ex As Exception
           MessageBox.Show(ex.Message)
       End Try
   End Sub
   

2. No C#, você deve adicionar um manipulador de eventos para o controle de usuário ao Startup evento, conforme mostrado abaixo. Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos em projetos do Office.

   this.ChartOptions1.SelectionChanged += new EventHandler(ChartOptions1_SelectionChanged);
   

Testar o aplicativo

Agora você pode testar sua pasta de trabalho para verificar se o gráfico está estilizado corretamente quando você seleciona um botão de opção.

Para testar sua pasta de trabalho

1. Pressione F5 para executar o projeto.

2. Selecione diversos botões de opção.

3. Confirme se as alterações no estilo gráfico correspondem à seleção.

Próximas etapas

Este passo a passo mostra as noções básicas do uso de botões de opção e estilos de gráfico em planilhas. Estas são algumas tarefas que podem vir a seguir:

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

• Usar um botão para preencher uma caixa de texto. Para obter mais informações, consulte Demonstra Passo a passo: Exibir texto em uma caixa de texto em uma planilha usando um botão.

• Altere a formatação em uma planilha usando caixas de seleção.

Conteúdo relacionado

• Instruções passo a passo usando o Excel