Como desenvolvedor C#, você pode inserir vários tipos de gráficos em documentos do Word programaticamente. Ajuda a apresentar graficamente seus dados e informações. Neste artigo, você aprenderá como criar gráficos em documentos do Word usando C#.
Os seguintes tópicos são discutidos/abordados neste artigo:
- API C# para inserir gráficos em documentos do Word
- Criar gráficos de colunas em documentos do Word
- Criar gráficos de dispersão em documentos do Word usando C#
- Inserir gráficos de área em documentos do Word usando C#
- Inserir gráficos de bolhas em documentos do Word usando C#
API C# para inserir gráficos em documentos do Word
Para inserir gráficos em arquivos DOCX, usaremos Aspose.Words for .NET API. Ele permite gerar, modificar, converter, renderizar e imprimir arquivos sem utilizar o Microsoft Word diretamente em aplicativos multiplataforma. A API permite que você insira vários tipos de gráfico suportados em documentos do Word programaticamente.
Você pode baixar a DLL da API ou instalá-la usando NuGet.
Install-Package Aspose.Words
Criar gráficos de colunas em documentos do Word
Você pode criar gráficos de colunas em documentos do Word programaticamente seguindo as etapas abaixo:
- Primeiramente, crie um novo documento usando a classe Document.
- Agora, crie uma instância da classe DocumentBuilder com o objeto da classe Document.
- Em seguida, chame o método DocumentBuilder.InsertChart(). Passe ChartType como Column, com height e width como parâmetros de entrada.
- Obtenha resultados no objeto de classe Shape.
- Agora, crie uma instância da classe Chart e atribua o objeto Shape.Chart a ela. Fornece acesso às propriedades do gráfico se esta forma tiver um Gráfico.
- Em seguida, obtenha a coleção de séries de gráficos no objeto ChartSeriesCollection.
- Crie uma matriz de nomes de categorias.
- Agora, chame o método ChartSeriesCollection.Add() para adicionar séries de gráficos. Passe nome, array de categorias e valores como parâmetros de entrada. Repita esta etapa para adicionar mais séries.
- Finalmente, chame o método Document.Save() com o caminho do arquivo de saída para salvar o arquivo.
O exemplo de código a seguir mostra como criar um gráfico de colunas em um documento do Word usando C#.
// Criar um documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Adicionar gráfico com dados padrão. Você pode especificar diferentes tipos e tamanhos de gráficos.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
// A propriedade Chart de Shape contém todas as opções relacionadas ao gráfico.
Chart chart = shape.Chart;
// Obtenha a coleção de séries de gráficos.
ChartSeriesCollection seriesColl = chart.Series;
// Verifique a contagem de séries.
Console.WriteLine(seriesColl.Count);
// Excluir série gerada padrão.
seriesColl.Clear();
// Crie um array de nomes de categorias, neste exemplo temos duas categorias.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// Adicionando novas séries. Observe que os arrays de dados não devem estar vazios e os arrays devem ter o mesmo tamanho.
seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
seriesColl.Add("AW Series 4", categories, new double[] { 7, 8 });
seriesColl.Add("AW Series 5", categories, new double[] { 9, 10 });
// Salve o documento
doc.Save(@"C:\Files\Words\ColumnsChart.docx");
Criar gráficos de dispersão em documentos do Word usando C#
Você pode inserir gráficos de dispersão em seus documentos do Word programaticamente seguindo as etapas mencionadas anteriormente. No entanto, você precisa definir ChartType.Scatter no método DocumentBuilder.InsertChart().
O exemplo de código a seguir mostra como criar um gráfico de dispersão em um documento do Word usando C#.
// Criar um novo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insira o gráfico de dispersão.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;
// Use essa sobrecarga para adicionar séries a qualquer tipo de gráfico de dispersão.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
// Salve o documento
doc.Save(@"C:\Files\Words\ScatterChart.docx");
Inserir gráficos de área em documentos do Word usando C#
Você pode inserir gráficos de área em documentos do Word programaticamente seguindo as etapas mencionadas anteriormente. No entanto, você precisa definir ChartType.Area no método DocumentBuilder.InsertChart().
O exemplo de código a seguir mostra como criar um gráfico de área em um documento do Word usando C#.
// Criar um novo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Inserir gráfico de área.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;
// Use essa sobrecarga para adicionar séries a qualquer tipo de gráfico de área, radar e estoque.
chart.Series.Add("AW Series 1", new DateTime[] {
new DateTime(2002, 05, 01),
new DateTime(2002, 06, 01),
new DateTime(2002, 07, 01),
new DateTime(2002, 08, 01),
new DateTime(2002, 09, 01)},
new double[] { 32, 32, 28, 12, 15 });
// Salve o documento
doc.Save(@"C:\Files\Words\AreaChart.docx");
Inserir gráficos de bolhas em documentos do Word usando C#
Você pode inserir gráficos de bolhas em documentos do Word programaticamente seguindo as etapas mencionadas anteriormente. No entanto, você precisa definir ChartType.Bubble no método DocumentBuilder.InsertChart().
O exemplo de código a seguir mostra como criar um gráfico de bolhas em um documento do Word usando C#.
// Criar um novo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insira o gráfico de bolhas.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;
// Use essa sobrecarga para adicionar séries a qualquer tipo de gráfico de bolhas.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 }, new double[] { 10, 4, 8 });
// Salve o documento
doc.Save(@"C:\Files\Words\BubbleChart.docx");
Obtenha uma licença gratuita
Você pode experimentar a API sem limitações de avaliação solicitando uma licença temporária gratuita.
Conclusão
Neste artigo, você aprendeu como criar gráficos em documentos do Word usando C#. Particularmente, você aprendeu como criar gráficos de coluna, área, bolha e dispersão em documentos do Word programaticamente. Da mesma forma, você pode criar outros tipos de gráficos. Você pode aprender mais sobre Aspose.Words para .NET API usando a documentação. Em caso de qualquer ambiguidade, não hesite em contactar-nos no fórum.