Trabalhar com gráficos
O novo método insertChart foi adicionado à classe DocumentBuilder. Então, vamos ver como inserir um gráfico de colunas simples no documento usando o método insertChart.
Como inserir um gráfico do zero usando Aspose.Words
Nesta seção, aprenderemos como inserir um gráfico em um documento.
Inserir Gráfico De Colunas
O exemplo de código a seguir mostra como inserir o gráfico de colunas:
O código produz o seguinte resultado:
Existem quatro sobrecargas diferentes para o método Add em série, que foram expostas para abranger todas as variantes possíveis de fontes de dados para todos os tipos de gráficos:
O código produz o seguinte resultado:
Inserir Gráfico De Dispersão
O exemplo de código a seguir mostra como inserir um gráfico de dispersão:
O código produz o seguinte resultado:
Inserir Gráfico De Área
O exemplo de código a seguir mostra como inserir um gráfico de área:
O código produz o seguinte resultado:
Inserir Gráfico De Bolhas
O exemplo de código a seguir mostra como inserir um gráfico de bolhas:
O código produz o seguinte resultado:
Trabalhando com gráficos através do objeto Shape.Chart
Uma vez que o gráfico foi inserido e preenchido com dados, você pode alterar sua aparência. A propriedade Shape.Chart contém todas as opções relacionadas ao gráfico disponíveis através do público API.
Por exemplo, vamos alterar o comportamento do título ou da legenda do Gráfico:
O código gera os seguintes resultados:
Como trabalhar com ChartSeriesCollection do Gráfico
Vamos dar uma olhada na coleção ChartSeries. Todas as séries de gráficos estão disponíveis através da coleção chart.getSeries(), que é Iterable:
Você pode remover uma série por uma ou limpar todas elas, bem como adicionar uma nova, se necessário. O gráfico recém-inserido tem algumas séries padrão adicionadas a esta coleção. Para removê-los, você precisa chamar o método chart.getSeries().clear().
Trabalhando com uma única classe ChartSeries
Aqui está como trabalhar com uma série específica.
Veja o resultado abaixo:
Todos os únicos ChartSeries têm opções padrão ChartDataPoint, tente usar o seguinte código para alterá - los:
Como trabalhar com um único ChartDataPoint de um ChartSeries
Usando ChartDataPoint você pode personalizar a formatação de um único ponto de dados da série de gráficos:
Veja o resultado abaixo:
Como trabalhar com ChartDataLabel de um único ChartSeries
Usando ChartDataLabel, você pode especificar a formatação de um único rótulo de dados da série de gráficos, como mostrar / ocultar LegendKey, CategoryName, SeriesName, Valor etc:
Veja o resultado abaixo:
Como definir opções padrão para ChartDataLabels de ChartSeries
A classe ChartDataLabelCollection define propriedades que podem ser usadas para definir opções padrão para ChartDataLabels para o gráfico Series. Essas propriedades incluem setShowCategoryName, setShowBubbleSize, setShowPercentage, setShowSeriesName, setShowValue etc:
Veja o resultado abaixo:
Como formatar o número do rótulo dos dados do Gráfico
Usando a propriedade NumberFormat, é possível especificar a formatação numérica de um único rótulo de dados do gráfico.
O exemplo de código a seguir mostra como formatar um número do rótulo de dados:
Como definir as propriedades do eixo do Gráfico
Se você quiser trabalhar com eixo de gráfico, dimensionamento e unidades de exibição para o eixo de valor, use as classes ChartAxis, AxisDisplayUnit e AxisScaling.
O exemplo de código a seguir mostra como definir as propriedades dos eixos X e Y:
Como definir DateTime Valor Do Eixo
O exemplo de código a seguir mostra como definir valores de data / hora para propriedades do eixo:
Como formatar o valor numérico do eixo
O exemplo de código a seguir mostra como alterar o formato dos números no eixo do valor:
Como definir limites de eixo
A classe AxisBound representa um limite mínimo ou máximo de valores de eixo. O limite pode ser especificado como um valor numérico, data-hora ou um valor especial “auto”.
O exemplo de código a seguir mostra como definir os limites de um eixo:
Como definir a unidade de intervalo entre rótulos
O exemplo de código a seguir mostra como definir a unidade de intervalo entre rótulos em um eixo:
Como ocultar o eixo do Gráfico
Se você quiser mostrar ou ocultar o eixo do gráfico, você pode simplesmente conseguir isso definindo o valor da propriedade ChartAxis.Hidden.
O exemplo de código a seguir mostra como ocultar o eixo Y do gráfico:
Como alinhar o rótulo do Gráfico
Se você quiser definir um alinhamento de texto para rótulos de várias linhas, você pode simplesmente conseguir isso definindo o valor da propriedade setTickLabelAlignment().
O exemplo de código a seguir mostra como marcar o alinhamento do rótulo:
Como definir a formatação de preenchimento e traçado
A formatação de preenchimento e traçado pode ser definida para séries de gráficos, pontos de dados e marcadores. Para fazer isso, você precisa usar as propriedades do tipo ChartFormat nas classes ChartSeries, ChartDataPoint e ChartMarker, bem como aliases para algumas propriedades, como ForeColor, BackColor, Visible e Transparency na classe Stroke.
O exemplo de código a seguir mostra como definir a cor da série:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Create category names array.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// Adding new series. Value and category arrays must be the same size.
ChartSeries series1 = seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
ChartSeries series2 = seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
ChartSeries series3 = seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
// Set series color.
series1.Format.Fill.ForeColor = Color.Red;
series2.Format.Fill.ForeColor = Color.Yellow;
series3.Format.Fill.ForeColor = Color.Blue;
doc.Save("ColumnColor.docx");
O exemplo de código a seguir mostra como definir a cor e o peso da linha:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Adding new series.
ChartSeries series1 = seriesColl.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
ChartSeries series2 = seriesColl.Add("AW Series 2", new double[] { 0.5, 1.5, 2.5 }, new double[] { 3, 1, 2 });
// Set series color.
series1.Format.Stroke.ForeColor = Color.Red;
series1.Format.Stroke.Weight = 5;
series2.Format.Stroke.ForeColor = Color.LightGreen;
series2.Format.Stroke.Weight = 5;
doc.Save("LineColorAndWeight.docx");