Represents a chart data marker.

Examples

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

void ChartDataPoint_()
{
    auto doc = MakeObject<Document>();
    auto builder = MakeObject<DocumentBuilder>(doc);
 
    SharedPtr<Shape> shape = builder->InsertChart(ChartType::Line, 500, 350);
    SharedPtr<Chart> chart = shape->get_Chart();
 
    ASSERT_EQ(3, chart->get_Series()->get_Count());
    ASSERT_EQ(u"Series 1", chart->get_Series()->idx_get(0)->get_Name());
    ASSERT_EQ(u"Series 2", chart->get_Series()->idx_get(1)->get_Name());
    ASSERT_EQ(u"Series 3", chart->get_Series()->idx_get(2)->get_Name());
 
    // Emphasize the chart's data points by making them appear as diamond shapes.
    for (const auto& series : System::IterateOver(chart->get_Series()))
    {
        ApplyDataPoints(series, 4, MarkerSymbol::Diamond, 15);
    }
 
    // Smooth out the line that represents the first data series.
    chart->get_Series()->idx_get(0)->set_Smooth(true);
 
    // Verify that data points for the first series will not invert their colors if the value is negative.
    {
        SharedPtr<System::Collections::Generic::IEnumerator<SharedPtr<ChartDataPoint>>> enumerator =
            chart->get_Series()->idx_get(0)->get_DataPoints()->GetEnumerator();
        while (enumerator->MoveNext())
        {
            ASSERT_FALSE(enumerator->get_Current()->get_InvertIfNegative());
        }
    }
 
    // For a cleaner looking graph, we can clear format individually.
    chart->get_Series()->idx_get(1)->get_DataPoints()->idx_get(2)->ClearFormat();
 
    // We can also strip an entire series of data points at once.
    chart->get_Series()->idx_get(2)->get_DataPoints()->ClearFormat();
 
    doc->Save(ArtifactsDir + u"Charts.ChartDataPoint.docx");
}
 
static void ApplyDataPoints(SharedPtr<ChartSeries> series, int dataPointsCount, MarkerSymbol markerSymbol, int dataPointSize)
{
    for (int i = 0; i < dataPointsCount; i++)
    {
        SharedPtr<ChartDataPoint> point = series->get_DataPoints()->idx_get(i);
        point->get_Marker()->set_Symbol(markerSymbol);
        point->get_Marker()->set_Size(dataPointSize);
 
        ASSERT_EQ(i, point->get_Index());
    }
}

#include <Aspose.Words.Cpp/Drawing/Charts/ChartMarker.h>

Inheritance diagram for Aspose::Words::Drawing::Charts::ChartMarker:

Public Member Functions
SharedPtr< Aspose::Words::Drawing::Core::Dml::Fills::DmlFill >	get_Fill () override

SharedPtr< ChartFormat >	get_Format ()
	Provides access to fill and line formatting of this marker. More...

SharedPtr< Aspose::Words::Drawing::Core::Dml::Outlines::DmlOutline >	get_Outline () override

int32_t	get_Size ()
	Gets or sets chart marker size. Default value is 7. More...

MarkerSymbol	get_Symbol ()
	Gets or sets chart marker symbol. More...

SharedPtr< Aspose::Words::Drawing::Core::Dml::Themes::IThemeProvider >	get_ThemeProvider () override

virtual const TypeInfo &	GetType () const override

virtual bool	Is (const TypeInfo &target) const override

void	MaterializeSpPr () override

void	set_Fill (SharedPtr< Aspose::Words::Drawing::Core::Dml::Fills::DmlFill > value) override

void	set_Outline (SharedPtr< Aspose::Words::Drawing::Core::Dml::Outlines::DmlOutline > value) override

void	set_Size (int32_t value)
	Setter for get_Size. More...

void	set_Symbol (MarkerSymbol value)
	Setter for get_Symbol. More...

Static Public Member Functions
static const TypeInfo &	Type ()

Member Function Documentation

◆ get_Fill()

System::SharedPtr<Aspose::Words::Drawing::Core::Dml::Fills::DmlFill> Aspose::Words::Drawing::Charts::ChartMarker::get_Fill ( )

override

◆ get_Format()

System::SharedPtr<Aspose::Words::Drawing::Charts::ChartFormat> Aspose::Words::Drawing::Charts::ChartMarker::get_Format ( )

Provides access to fill and line formatting of this marker.

◆ get_Outline()

System::SharedPtr<Aspose::Words::Drawing::Core::Dml::Outlines::DmlOutline> Aspose::Words::Drawing::Charts::ChartMarker::get_Outline ( )

override

◆ get_Size()

int32_t Aspose::Words::Drawing::Charts::ChartMarker::get_Size ( )

Gets or sets chart marker size. Default value is 7.

Examples

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

void ChartDataPoint_()
{
    auto doc = MakeObject<Document>();
    auto builder = MakeObject<DocumentBuilder>(doc);
 
    SharedPtr<Shape> shape = builder->InsertChart(ChartType::Line, 500, 350);
    SharedPtr<Chart> chart = shape->get_Chart();
 
    ASSERT_EQ(3, chart->get_Series()->get_Count());
    ASSERT_EQ(u"Series 1", chart->get_Series()->idx_get(0)->get_Name());
    ASSERT_EQ(u"Series 2", chart->get_Series()->idx_get(1)->get_Name());
    ASSERT_EQ(u"Series 3", chart->get_Series()->idx_get(2)->get_Name());
 
    // Emphasize the chart's data points by making them appear as diamond shapes.
    for (const auto& series : System::IterateOver(chart->get_Series()))
    {
        ApplyDataPoints(series, 4, MarkerSymbol::Diamond, 15);
    }
 
    // Smooth out the line that represents the first data series.
    chart->get_Series()->idx_get(0)->set_Smooth(true);
 
    // Verify that data points for the first series will not invert their colors if the value is negative.
    {
        SharedPtr<System::Collections::Generic::IEnumerator<SharedPtr<ChartDataPoint>>> enumerator =
            chart->get_Series()->idx_get(0)->get_DataPoints()->GetEnumerator();
        while (enumerator->MoveNext())
        {
            ASSERT_FALSE(enumerator->get_Current()->get_InvertIfNegative());
        }
    }
 
    // For a cleaner looking graph, we can clear format individually.
    chart->get_Series()->idx_get(1)->get_DataPoints()->idx_get(2)->ClearFormat();
 
    // We can also strip an entire series of data points at once.
    chart->get_Series()->idx_get(2)->get_DataPoints()->ClearFormat();
 
    doc->Save(ArtifactsDir + u"Charts.ChartDataPoint.docx");
}
 
static void ApplyDataPoints(SharedPtr<ChartSeries> series, int dataPointsCount, MarkerSymbol markerSymbol, int dataPointSize)
{
    for (int i = 0; i < dataPointsCount; i++)
    {
        SharedPtr<ChartDataPoint> point = series->get_DataPoints()->idx_get(i);
        point->get_Marker()->set_Symbol(markerSymbol);
        point->get_Marker()->set_Size(dataPointSize);
 
        ASSERT_EQ(i, point->get_Index());
    }
}

◆ get_Symbol()

Aspose::Words::Drawing::Charts::MarkerSymbol Aspose::Words::Drawing::Charts::ChartMarker::get_Symbol ( )

Gets or sets chart marker symbol.

Examples

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

void ChartDataPoint_()
{
    auto doc = MakeObject<Document>();
    auto builder = MakeObject<DocumentBuilder>(doc);
 
    SharedPtr<Shape> shape = builder->InsertChart(ChartType::Line, 500, 350);
    SharedPtr<Chart> chart = shape->get_Chart();
 
    ASSERT_EQ(3, chart->get_Series()->get_Count());
    ASSERT_EQ(u"Series 1", chart->get_Series()->idx_get(0)->get_Name());
    ASSERT_EQ(u"Series 2", chart->get_Series()->idx_get(1)->get_Name());
    ASSERT_EQ(u"Series 3", chart->get_Series()->idx_get(2)->get_Name());
 
    // Emphasize the chart's data points by making them appear as diamond shapes.
    for (const auto& series : System::IterateOver(chart->get_Series()))
    {
        ApplyDataPoints(series, 4, MarkerSymbol::Diamond, 15);
    }
 
    // Smooth out the line that represents the first data series.
    chart->get_Series()->idx_get(0)->set_Smooth(true);
 
    // Verify that data points for the first series will not invert their colors if the value is negative.
    {
        SharedPtr<System::Collections::Generic::IEnumerator<SharedPtr<ChartDataPoint>>> enumerator =
            chart->get_Series()->idx_get(0)->get_DataPoints()->GetEnumerator();
        while (enumerator->MoveNext())
        {
            ASSERT_FALSE(enumerator->get_Current()->get_InvertIfNegative());
        }
    }
 
    // For a cleaner looking graph, we can clear format individually.
    chart->get_Series()->idx_get(1)->get_DataPoints()->idx_get(2)->ClearFormat();
 
    // We can also strip an entire series of data points at once.
    chart->get_Series()->idx_get(2)->get_DataPoints()->ClearFormat();
 
    doc->Save(ArtifactsDir + u"Charts.ChartDataPoint.docx");
}
 
static void ApplyDataPoints(SharedPtr<ChartSeries> series, int dataPointsCount, MarkerSymbol markerSymbol, int dataPointSize)
{
    for (int i = 0; i < dataPointsCount; i++)
    {
        SharedPtr<ChartDataPoint> point = series->get_DataPoints()->idx_get(i);
        point->get_Marker()->set_Symbol(markerSymbol);
        point->get_Marker()->set_Size(dataPointSize);
 
        ASSERT_EQ(i, point->get_Index());
    }
}

◆ get_ThemeProvider()

System::SharedPtr<Aspose::Words::Drawing::Core::Dml::Themes::IThemeProvider> Aspose::Words::Drawing::Charts::ChartMarker::get_ThemeProvider ( )

override

◆ GetType()

virtual const System::TypeInfo& Aspose::Words::Drawing::Charts::ChartMarker::GetType ( ) const

overridevirtual

◆ Is()

virtual bool Aspose::Words::Drawing::Charts::ChartMarker::Is ( const System::TypeInfo & target ) const

overridevirtual

◆ MaterializeSpPr()

void Aspose::Words::Drawing::Charts::ChartMarker::MaterializeSpPr ( )

override

◆ set_Fill()

void Aspose::Words::Drawing::Charts::ChartMarker::set_Fill ( System::SharedPtr< Aspose::Words::Drawing::Core::Dml::Fills::DmlFill > value )

override

◆ set_Outline()

void Aspose::Words::Drawing::Charts::ChartMarker::set_Outline ( System::SharedPtr< Aspose::Words::Drawing::Core::Dml::Outlines::DmlOutline > value )

override

◆ set_Size()

void Aspose::Words::Drawing::Charts::ChartMarker::set_Size ( int32_t value )

Setter for Aspose::Words::Drawing::Charts::ChartMarker::get_Size.

◆ set_Symbol()

void Aspose::Words::Drawing::Charts::ChartMarker::set_Symbol ( Aspose::Words::Drawing::Charts::MarkerSymbol value )

Setter for Aspose::Words::Drawing::Charts::ChartMarker::get_Symbol.

◆ Type()

static const System::TypeInfo& Aspose::Words::Drawing::Charts::ChartMarker::Type ( )

static

Public Member Functions

Static Public Member Functions

Member Function Documentation

◆ get_Fill()

◆ get_Format()

◆ get_Outline()

◆ get_Size()

◆ get_Symbol()

◆ get_ThemeProvider()

◆ GetType()

◆ Is()

◆ MaterializeSpPr()

◆ set_Fill()

◆ set_Outline()

◆ set_Size()

◆ set_Symbol()

◆ Type()