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

Artigo
09/23/2023

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

Abra o Microsoft Excel.
Clique com o botão direito do mouse na guia Sheet3 e, em seguida, clique em Renomear no menu de atalho.
Renomeie a planilha para Dados para Gráfico.
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.

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

Para adicionar um gráfico no Excel

No separador Inserir, no grupo Gráficos, clique em Coluna e, em seguida, clique em Todos os Tipos de Gráfico.
Na caixa de diálogo Inserir Gráfico, clique em OK.
Na guia Design, no grupo Dados, clique em Selecionar Dados.
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.
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.
Na caixa de diálogo Selecionar Fonte de Dados, clique em OK.
Reposicione o gráfico para que o canto superior direito se alinhe com a célula E2.
Salve seu arquivo na unidade C e nomeie-o ExcelChart.xlsx.
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

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.
Clique no botão Procurar e navegue até a pasta de trabalho criada anteriormente nesta explicação passo a passo.
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

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

Propriedade Valor

Nome dataGráfico

HasLegend false

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

Selecione o projeto Meu Gráfico do Excel no Gerenciador de Soluções.
No menu Projeto , clique em Adicionar Novo Item.
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

Se o controle de usuário não estiver visível no designer, clique duas vezes em ChartOptions no Gerenciador de Soluções.
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
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
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
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.

Propriedade	Valor
Nome	columnChart
Texto	Gráfico de colunas

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

Propriedade	Valor
Nome	lineChart
Texto	Gráfico de linhas

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

O controle de usuário ChartOptions é adicionado à caixa de ferramentas.
No Gerenciador de Soluções, clique com o botão direito do mouse em Sheet1.vb ou Sheet1.cs e clique em Exibir Designer.
Arraste o controle ChartOptions da caixa de ferramentas para a planilha.

Um novo controle chamado my_Excel_Chart_ChartOptions1 é adicionado ao seu projeto.
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

Adicione o manipulador de eventos a seguir à classe Sheet1.

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

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

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

Pressione F5 para executar o projeto.
Selecione diversos botões de opção.
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.

Instruções passo a passo usando o Excel

Compartilhar via

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

Pré-requisitos

Adicionar um gráfico a uma planilha

Para adicionar os dados

Para adicionar um gráfico no Excel

Crie um novo projeto

Criar um novo projeto

Definir propriedades do gráfico

Para alterar o nome do controle Chart

Adicionar controles

Para adicionar um controle de usuário

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

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

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

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

Adicionar o controle de usuário à planilha

Para adicionar o controle de usuário à sua planilha

Alterar o tipo de gráfico

Para alterar o tipo de gráfico exibido na planilha

Testar o aplicativo

Para testar sua pasta de trabalho

Próximas etapas

Comentários

Recursos adicionais

Compartilhar via

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

Pré-requisitos

Adicionar um gráfico a uma planilha

Para adicionar os dados

Para adicionar um gráfico no Excel

Crie um novo projeto

Criar um novo projeto

Definir propriedades do gráfico

Para alterar o nome do controle Chart

Adicionar controles

Para adicionar um controle de usuário

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

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

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

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

Adicionar o controle de usuário à planilha

Para adicionar o controle de usuário à sua planilha

Alterar o tipo de gráfico

Para alterar o tipo de gráfico exibido na planilha

Testar o aplicativo

Para testar sua pasta de trabalho

Próximas etapas

Conteúdo relacionado

Comentários

Recursos adicionais