Aspose::Words::Drawing::Charts::ChartSeriesCollection class

ChartSeriesCollection class

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

class ChartSeriesCollection : public System::Collections::Generic::IEnumerable<System::SharedPtr<Aspose::Words::Drawing::Charts::ChartSeries>>

Methods

MethodDescription
Add(const System::String&, const System::ArrayPtr<System::String>&, const System::ArrayPtr<double>&)Adds new ChartSeries to this collection. Use this method to add series to any type of Bar, Column, Line and Surface charts.
Add(const System::String&, const System::ArrayPtr<double>&, const System::ArrayPtr<double>&)Adds new ChartSeries to this collection. Use this method to add series to any type of Scatter charts.
Add(const System::String&, const System::ArrayPtr<System::DateTime>&, const System::ArrayPtr<double>&)Adds new ChartSeries to this collection. Use this method to add series to any type of Area, Radar and Stock charts.
Add(const System::String&, const System::ArrayPtr<double>&, const System::ArrayPtr<double>&, const System::ArrayPtr<double>&)Adds new ChartSeries to this collection. Use this method to add series to any type of Bubble charts.
Add(const System::String&, const System::ArrayPtr<System::SharedPtr<Aspose::Words::Drawing::Charts::ChartMultilevelValue>>&, const System::ArrayPtr<double>&)Adds new ChartSeries to this collection. Use this method to add series that have multi-level data categories.
Add(const System::String&, const System::ArrayPtr<double>&)Adds new ChartSeries to this collection. Use this method to add series to Histogram charts.
Add(const System::String&, const System::ArrayPtr<System::String>&, const System::ArrayPtr<double>&, const System::ArrayPtr<bool>&)
Clear()Removes all ChartSeries from this collection.
get_Count()Returns the number of ChartSeries in this collection.
GetEnumerator() overrideReturns an enumerator object.
GetType() const override
idx_get(int32_t)Returns a ChartSeries at the specified index.
Is(const System::TypeInfo&) const override
RemoveAt(int32_t)Removes a ChartSeries at the specified index.
static Type()

Examples

Shows how to add and remove series data in a chart.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

// Insert a column chart that will contain three series of demo data by default.
System::SharedPtr<Aspose::Words::Drawing::Shape> chartShape = builder->InsertChart(Aspose::Words::Drawing::Charts::ChartType::Column, 400, 300);
System::SharedPtr<Aspose::Words::Drawing::Charts::Chart> chart = chartShape->get_Chart();

// Each series has four decimal values: one for each of the four categories.
// Four clusters of three columns will represent this data.
System::SharedPtr<Aspose::Words::Drawing::Charts::ChartSeriesCollection> chartData = chart->get_Series();

ASSERT_EQ(3, chartData->get_Count());

// Print the name of every series in the chart.
{
    System::SharedPtr<System::Collections::Generic::IEnumerator<System::SharedPtr<Aspose::Words::Drawing::Charts::ChartSeries>>> enumerator = chart->get_Series()->GetEnumerator();
    while (enumerator->MoveNext())
    {
        std::cout << enumerator->get_Current()->get_Name() << std::endl;
    }
}

// These are the names of the categories in the chart.
System::ArrayPtr<System::String> categories = System::MakeArray<System::String>({u"Category 1", u"Category 2", u"Category 3", u"Category 4"});

// We can add a series with new values for existing categories.
// This chart will now contain four clusters of four columns.
chart->get_Series()->Add(u"Series 4", categories, System::MakeArray<double>({4.4, 7.0, 3.5, 2.1}));

// A chart series can also be removed by index, like this.
// This will remove one of the three demo series that came with the chart.
chartData->RemoveAt(2);

ASSERT_FALSE(chartData->LINQ_Any(static_cast<System::Func<System::SharedPtr<Aspose::Words::Drawing::Charts::ChartSeries>, bool>>(static_cast<std::function<bool(System::SharedPtr<Aspose::Words::Drawing::Charts::ChartSeries> s)>>([](System::SharedPtr<Aspose::Words::Drawing::Charts::ChartSeries> s) -> bool
{
    return s->get_Name() == u"Series 3";
}))));

// We can also clear all the chart's data at once with this method.
// When creating a new chart, this is the way to wipe all the demo data
// before we can begin working on a blank chart.
chartData->Clear();

See Also

Aspose::Words::Drawing::Charts::ChartSeries class Aspose::Words::Drawing::Charts::ChartSeriesGroup class