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.

from api_example_base import ApiExampleBase, ARTIFACTS_DIR
import aspose.words as aw
import aspose.pydrawing as drawing
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
shape = builder.insert_chart(chart_type=aw.drawing.charts.ChartType.LINE, width=500, height=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:
    ExCharts._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:
    assert not data_point.invert_if_negative
data_point = chart.series[1].data_points[2]
data_point.format.fill.color = drawing.Color.red
# For a cleaner looking graph, we can clear format individually.
data_point.clear_format()
# We can also strip an entire series of data points at once.
chart.series[2].data_points.clear_format()
doc.save(file_name=ARTIFACTS_DIR + 'Charts.ChartDataPoint.docx')

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

@staticmethod
def _apply_data_points(series, data_points_count, marker_symbol, data_point_size):
    i = 0
    while i < data_points_count:
        point = series.data_points[i]
        point.marker.symbol = marker_symbol
        point.marker.size = data_point_size
        assert i == point.index
        i += 1

See Also

• module aspose.words.drawing.charts