ChartDataPointCollection class

ChartDataPointCollection class

Represents collection of a ChartDataPoint. To learn more, visit the Working with Charts documentation article.

Indexers

Name	Description
__getitem__(index)	Returns ChartDataPoint for the specified index.

Properties

Name	Description
count	Returns the number of ChartDataPoint in this collection.

Methods

Name	Description
clear_format()	Clears format of all ChartDataPoint in this collection.
copy_format(source_index, destination_index)	Copies format from the source data point to the destination data point.
has_default_format(data_point_index)	Gets a flag indicating whether the data point at the specified index has default format.

Examples

Shows how to work with data points on a line chart.

def test_chart_data_point(self):

    doc = aw.Document()
    builder = aw.DocumentBuilder(doc)

    shape = builder.insert_chart(aw.drawing.charts.ChartType.LINE, 500, 350)
    chart = shape.chart

    self.assertEqual(3, chart.series.count)
    self.assertEqual("Series 1", chart.series[0].name)
    self.assertEqual("Series 2", chart.series[1].name)
    self.assertEqual("Series 3", chart.series[2].name)

    # Emphasize the chart's data points by making them appear as diamond shapes.
    for series in chart.series:
        self.apply_data_points(series, 4, aw.drawing.charts.MarkerSymbol.DIAMOND, 15)

    # Smooth out the line that represents the first data series.
    chart.series[0].smooth = True

    # Verify that data points for the first series will not invert their colors if the value is negative.
    for data_point in chart.series[0].data_points:
        self.assertFalse(data_point.invert_if_negative)

    # For a cleaner looking graph, we can clear format individually.
    chart.series[1].data_points[2].clear_format()

    # We can also strip an entire series of data points at once.
    chart.series[2].data_points.clear_format()

    doc.save(ARTIFACTS_DIR + "Charts.chart_data_point.docx")

def apply_data_points(self, series: aw.drawing.charts.ChartSeries, data_points_count: int, marker_symbol: aw.drawing.charts.MarkerSymbol, data_point_size: int):
    """Applies a number of data points to a series."""

    for i in range(data_points_count):
        point = series.data_points[i]
        point.marker.symbol = marker_symbol
        point.marker.size = data_point_size

        self.assertEqual(i, point.index)

See Also

• module aspose.words.drawing.charts