Adicionar controles de gráfico a planilhas

  • Artigo

Você pode adicionar Chart controles a uma planilha do Microsoft Office Excel no momento do design e de execução em personalizações no nível do documento. Você também pode adicionar controles Chart no tempo de execução em suplementos VSTO.

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

Este tópico descreve as seguintes tarefas:

Adicionar controles de gráfico no momento do design

Você pode adicionar o controle Chart à sua planilha da mesma maneira que adicionaria um gráfico de dentro do aplicativo.

Observação

O controle Chart não está disponível na Caixa de Ferramentas ou na janela Fontes de Dados.

Para adicionar um controle de host de gráfico a uma planilha no Excel

  1. Na guia Inserir, no grupo Gráficos, clique em Coluna, clique em uma categoria de gráficos e clique no tipo de gráfico desejado.

  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 de intervalo de dados do Gráfico e desmarque qualquer seleção padrão.

  5. Na planilha Dados para Gráfico, selecione o intervalo de células que contém os dados do gráfico (células A5 a D8).

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

Adicionar controles de gráfico no tempo de execução em um projeto no nível do documento

Você pode adicionar o controle Chart dinamicamente no tempo de execução. Os gráficos criados dinamicamente não são mantidos no documento como controles de host quando o documento é fechado. Para obter mais informações, consulte Adicionar controles a documentos do Office em tempo de execução.

Para adicionar um controle de gráfico a uma planilha de forma programática

  1. No manipulador de eventos Startup de Sheet1, insira o código a seguir para adicionar o controle Chart.

    Microsoft.Office.Tools.Excel.Chart employeeData;
employeeData = this.Controls.AddChart(25, 110, 200, 150, "employees");
employeeData.ChartType = Excel.XlChartType.xl3DPie;

// Gets the cells that define the data to be charted.
Excel.Range chartRange = this.get_Range("A5", "D8");
employeeData.SetSourceData(chartRange, missing);

Adicionar controles de gráfico no tempo de execução em um projeto do suplemento VSTO

Você pode adicionar um controle Chart programaticamente a qualquer planilha aberta em um projeto do suplemento VSTO. Para mais informações, consulte Estender documentos do Word e pastas de trabalho do Excel em suplementos do VSTO no runtime.

Os controles de gráfico criados dinamicamente não são mantidos na planilha como controles de host quando a planilha é fechada. Para obter mais informações, consulte Adicionar controles a documentos do Office em tempo de execução.

Para adicionar um controle de gráfico a uma planilha de forma programática

  1. O código a seguir gera um item de host de planilha baseado na planilha aberta e, em seguida, adiciona um controle Chart.

    private void AddChart()
{
    Worksheet worksheet = Globals.Factory.GetVstoObject(
        Globals.ThisAddIn.Application.ActiveWorkbook.ActiveSheet);


    Excel.Range cells = worksheet.Range["A5", "D8"];
    Chart chart = worksheet.Controls.AddChart(cells, "employees");
    chart.ChartType = Microsoft.Office.Interop.Excel.XlChartType.xl3DPie;
    chart.SetSourceData(cells);
}

Compilar o código

Esse exemplo possui os seguintes requisitos:

  • Dados a serem mapeados, armazenados no intervalo de A5 a D8 na planilha.

Conteúdo relacionado