Os gráficos são usados para refletir informações de maneira fácil de entender. Planilhas são usadas por quase todos os escritórios para gerenciar dados, mas não são tão fáceis de ler. É por isso que um gráfico, geralmente conhecido como gráfico no Excel, é útil para apresentar uma visão geral dos dados. O Aspose.Cells for Cloud API é rico em APIs de manipulação de gráficos. Neste artigo, aprenderemos os seguintes recursos:
- Adicionar gráfico na planilha do Excel
- Excluir gráfico na planilha do Excel
- Atualizar gráfico existente na planilha do Excel
A API pode ser chamada de qualquer plataforma usando qualquer linguagem de programação. Diferentes SDKs estão disponíveis, incluindo Python, PHP, Ruby, Perl, Go, Swift e muitos mais. Você pode escolher e usá-lo entre qualquer um deles conforme sua conveniência. Aqui, usaremos código C# para esses exemplos.
Adicionar gráfico na planilha do Excel
Você pode inserir um gráfico ou um diagrama em uma pasta de trabalho do Excel com a API Aspose.Cells Cloud. Basta especificar as propriedades necessárias do gráfico, como Tipo de Gráfico, Área do Gráfico e, em seguida, fazer a chamada da API. Abaixo está um código de exemplo que adiciona um Gráfico de Pizza a uma planilha:
// Obtenha AppKey e AppSID de https://dashboard.aspose.cloud/
// Instalar pacote Nuget Aspose.Cells-Cloud
// Para exemplos completos e arquivos de dados, acesse https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet
CellsApi cellsApi = new CellsApi(AppKey, AppSid);
string name = "myDocument.xlsx";
string sheetName = "SHEET4";
string chartType = "Pie";
int? upperLeftRow = 5;
int? upperLeftColumn = 5;
int? lowerRightRow = 10;
int? lowerRightColumn = 10;
string area = "C7:D11";
bool? isVertical = true;
string categoryData = null;
bool? isAutoGetSerialName = null;
string title = null;
string folder = "TEMPFOLDER";
UpdateDataFile(cellsApi,folder, name);
var response = cellsApi.CellsChartsPutWorksheetAddChart(name, sheetName, chartType, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn, area, isVertical, categoryData, isAutoGetSerialName, title, folder);
Este trecho de código criará um gráfico conforme exibido na captura de tela a seguir:
Excluir gráfico da planilha do Excel
Você pode excluir ou remover um gráfico existente de um arquivo XLSX ou XLS com a API Aspose.Cells Cloud. Basta especificar o nome do arquivo, o nome da planilha e o índice do gráfico. Posteriormente, chame a API e o respectivo gráfico será excluído da planilha. No entanto, os dados permanecerão inalterados nas células como estão, apenas o gráfico será excluído. O seguinte trecho de código pode ser usado para o mesmo propósito:
// Obtenha AppKey e AppSID de https://dashboard.aspose.cloud/
// Instalar pacote Nuget Aspose.Cells-Cloud
// Para exemplos completos e arquivos de dados, acesse https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet
CellsApi cellsApi = new CellsApi(AppKey, AppSid);
string name = "myDocument1.xlsx";
string sheetName = "SHEET4";
int? chartIndex = 0;
string folder = "TEMPFOLDER";
UpdateDataFile(cellsApi,folder, name);
var response = cellsApi.CellsChartsDeleteWorksheetDeleteChart(name, sheetName, chartIndex, folder);
A captura de tela abaixo mostra a planilha de saída onde os dados permanecem os mesmos e o gráfico é excluído.
Atualizar um gráfico na planilha do Excel
Como já consideramos dois dos recursos de manipulação de gráficos acima, vamos verificar outro recurso de atualização de um gráfico existente. Aqui, atualizaremos o título do gráfico especificando o nome do arquivo Excel, o nome da planilha e o índice do gráfico como no seguinte trecho de código C#:
// Obtenha AppKey e AppSID de https://dashboard.aspose.cloud/
// Instalar pacote Nuget Aspose.Cells-Cloud
// Para exemplos completos e arquivos de dados, acesse https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet
CellsApi cellsApi = new CellsApi(AppKey, AppSid);
string name = "myDocument.xlsx";
string sheetName = "SHEET3";
int? chartIndex = 0;
Title title = new Title();
title.Text = "Test title";
string folder = "TEMPFOLDER";
UpdateDataFile(cellsApi,folder, name);
var response = cellsApi.CellsChartsPostWorksheetChartTitle(name, sheetName, chartIndex, title, folder);
A saída desse trecho de código pode ser observada na captura de tela abaixo. O título do gráfico é o mesmo que o especificado por nós.
Esses são alguns dos muitos recursos de manipulação de gráficos oferecidos pela API. Você pode inscrever-se gratuitamente e testar as APIs em sua capacidade total. Em caso de dúvidas, escreva para nós em Free Support Forums.