add method

add(xValue)

Adds the specified X value to the chart series. If the series supports Y values and bubble sizes, they will be empty for the X value.

add(xValue: Aspose.Words.Drawing.Charts.ChartXValue)
ParameterTypeDescription
xValueChartXValue

add(xValue, yValue)

Adds the specified X and Y values to the chart series.

add(xValue: Aspose.Words.Drawing.Charts.ChartXValue, yValue: Aspose.Words.Drawing.Charts.ChartYValue)
ParameterTypeDescription
xValueChartXValue
yValueChartYValue

add(xValue, yValue, bubbleSize)

Adds the specified X value, Y value and bubble size to the chart series.

add(xValue: Aspose.Words.Drawing.Charts.ChartXValue, yValue: Aspose.Words.Drawing.Charts.ChartYValue, bubbleSize: number)
ParameterTypeDescription
xValueChartXValue
yValueChartYValue
bubbleSizenumber

Examples

Shows how to populate chart series with data.

let doc = new aw.Document();
let builder = new aw.DocumentBuilder(doc);

let shape = builder.insertChart(aw.Drawing.Charts.ChartType.Column, 432, 252);
let chart = shape.chart;
let series1 = chart.series.at(0);

// Clear X and Y values of the first series.
series1.clearValues();

// Populate the series with data.
series1.add(aw.Drawing.Charts.ChartXValue.fromDouble(3), aw.Drawing.Charts.ChartYValue.fromDouble(10), 10);
series1.add(aw.Drawing.Charts.ChartXValue.fromDouble(5), aw.Drawing.Charts.ChartYValue.fromDouble(5));
series1.add(aw.Drawing.Charts.ChartXValue.fromDouble(7), aw.Drawing.Charts.ChartYValue.fromDouble(11));
series1.add(aw.Drawing.Charts.ChartXValue.fromDouble(9));

let series2 = chart.series.at(1);
// Clear X and Y values of the second series.
series2.clear();

// Populate the series with data.
series2.add(aw.Drawing.Charts.ChartXValue.fromDouble(2), aw.Drawing.Charts.ChartYValue.fromDouble(4));
series2.add(aw.Drawing.Charts.ChartXValue.fromDouble(4), aw.Drawing.Charts.ChartYValue.fromDouble(7));
series2.add(aw.Drawing.Charts.ChartXValue.fromDouble(6), aw.Drawing.Charts.ChartYValue.fromDouble(14));
series2.add(aw.Drawing.Charts.ChartXValue.fromDouble(8), aw.Drawing.Charts.ChartYValue.fromDouble(7));

doc.save(base.artifactsDir + "Charts.PopulateChartWithData.docx");

Shows how to add/remove chart data values.

let doc = new aw.Document();
let builder = new aw.DocumentBuilder();

let shape = builder.insertChart(aw.Drawing.Charts.ChartType.Column, 432, 252);
let chart = shape.chart;
let department1Series = chart.series.at(0);
let department2Series = chart.series.at(1);

// Remove the first value in the both series.
department1Series.remove(0);
department2Series.remove(0);

// Add new values to the both series.
let newXCategory = aw.Drawing.Charts.ChartXValue.fromString("Q1, 2023");
department1Series.add(newXCategory, aw.Drawing.Charts.ChartYValue.fromDouble(10.3));
department2Series.add(newXCategory, aw.Drawing.Charts.ChartYValue.fromDouble(5.7));

doc.save(base.artifactsDir + "Charts.ChartDataValues.docx");

See Also