ChartDataPointCollection class

ChartDataPointCollection class

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

Indexers

NameDescription
__getitem__(index)Returns ChartDataPoint for the specified index.

Properties

NameDescription
countReturns the number of ChartDataPoint in this collection.

Methods

NameDescription
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 chart_data_point():
    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:
        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(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