Trabalhando com gráficos
O novo insertChart método foi adicionado ao DocumentBuilder classe. Então, vamos ver como inserir um gráfico de colunas simples no documento usando inserção Gráfico método.
Como Inserir um Gráfico a partir do Scratch usando Aspose.Words
Nesta seção aprenderemos como inserir um gráfico em um documento.
Inserir gráfico de coluna
O exemplo de código a seguir mostra como inserir o gráfico da coluna:
O código produz o seguinte resultado:
Existem quatro sobrecargas diferentes para a série Adicionar método, que foram expostos para cobrir todas as variantes possíveis de fontes de dados para todos os tipos de gráficos:
O código produz o seguinte resultado:
Inserir scatter Gráfico
O exemplo a seguir mostra como inserir um gráfico de dispersão:
O código produz o seguinte resultado:
Área de inserção Gráfico
O exemplo a seguir mostra como inserir um gráfico de área:
O código produz o seguinte resultado:
Inserir gráfico de bolhas
O exemplo a seguir mostra como inserir um gráfico de bolhas:
O código produz o seguinte resultado:
Trabalhando com gráficos através Shape.Chart
Objeto
Uma vez que o gráfico foi inserido e preenchido com dados, você é capaz de mudar sua aparência. Shape.Chart propriedade contém todas as opções relacionadas ao gráfico disponíveis através do público API.
Por exemplo, vamos mudar Título do gráfico ou comportamento da lenda:
O código gera os seguintes resultados:
Como Trabalhar com ChartSeriesCollection of Chart
Vamos olhar para ChartSeries coleção. Todas as séries de gráficos estão disponíveis através do chart.getSeries() coleção, que é Iterable:
Você pode remover a série um por um ou limpar todos eles, bem como adicionar um novo se necessário. O gráfico recentemente inserido tem algumas séries padrão adicionadas a esta coleção. Para removê-los você precisa chamar o chart.getSeries().clear() método.
Trabalhando com uma única classe ChartSeries
Aqui está como trabalhar com uma série particular.
Por favor, veja o resultado abaixo:
Todos ChartSeries ter padrão ChartDataPoint opções, tente usar o seguinte código para alterá-los:
Como Trabalhar com ChartDataPoint Único de um ChartSeries
Usando ChartDataPoint você é capaz de personalizar a formatação de um único ponto de dados da série gráfico:
Por favor, veja o resultado abaixo:
Como Trabalhar com ChartDataLabel de uma única série de gráficos
Usando ChartDataLabel você é capaz de especificar a formatação de um único rótulo de dados da série gráfico, como show/hide LegendKey, CategoriaName, SeriesName, Valor etc
Por favor, veja o resultado abaixo:
Como definir opções padrão para ChartDataLabels de ChartSeries
O ChartDataLabelCollection classe define propriedades que podem ser usadas para definir opções padrão para ChartDataLabels para Gráfico Series. Estas propriedades incluem setShowCategoryName, setShowBubbleSize, setShowPercentage, setShowSeriesName, setShowShow Valor etc
Por favor, veja o resultado abaixo:
Como Formatar o Número de Gráficos
Usando o NumberFormat propriedade, você pode especificar a formatação de números 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 Propriedades do Eixo de Gráfico
Se você quiser trabalhar com o eixo do gráfico, escalar e exibir unidades para o eixo do valor, use ChartAxis, AxisDisplayUnit, e AxisScaling aulas.
O exemplo a seguir mostra como definir propriedades X e Y-axis:
Como Definir DateValor do tempo de Eixo
O exemplo de código a seguir mostra como definir valores de data/hora em propriedades de eixo:
Como formatar o valor do número de eixos
O exemplo de código a seguir mostra como alterar o formato de números no eixo de valor:
Como Definir Conjuntos de Eixos
O AxisBound
classe representa um limite mínimo ou máximo de valores de eixo. Bound pode ser especificado como um 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 Unidade de Intervalo entre Etiquetas
O exemplo de código a seguir mostra como definir a unidade de intervalo entre etiquetas em um eixo:
Como Esconder Eixos Gráficos
Se você quiser mostrar ou ocultar o eixo do gráfico, você pode simplesmente alcançar isso definindo o valor de ChartAxis.Hidden
propriedade.
O exemplo de código a seguir mostra como ocultar o eixo Y do gráfico:
Como Alinhar etiqueta de gráfico
Se você quiser definir um alinhamento de texto para etiquetas multi-linha, você pode simplesmente alcançar isso definindo o valor de setTickLabelAlignment() propriedade.
O exemplo a seguir mostra como marcar o alinhamento da etiqueta:
Como configurar a formatação de preenchimento e curso
A formatação de preenchimento e curso pode ser definida para séries de gráficos, pontos de dados e marcadores. Para fazer isso, você precisa usar as propriedades do ChartFormat
tipo nas classes ChartSeries, ChartDataPoint e ChartMarker, bem como pseudônimos para algumas propriedades, como ForeColor, BackColor, Visible e Transparência no Stroke
classe.
O seguinte exemplo de código 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 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");