MarkerBase Class

Represents a base class containing the common settings of data point markers.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[TypeConverter(typeof(BaseMarkerTypeConverter))]
public class MarkerBase :
    ChartElement

VB.NET

<TypeConverter(GetType(BaseMarkerTypeConverter))>
Public Class MarkerBase
    Inherits ChartElement

Related API Members

The following members return MarkerBase objects:

• BubbleSeriesView.BubbleMarkerOptions
• PointDrawOptionsBase.Marker

Remarks

The MarkerBase class contains the settings that define the data point marker functionality, and at the same time serves as a base for the SimpleMarker class.

The properties exposed by the MarkerBase class are common to markers which can be displayed by series of different types, and allow you to specify a marker’s background fill style (MarkerBase.FillStyle), border settings (MarkerBase.BorderColor, MarkerBase.BorderVisible), define the marker shape (MarkerBase.Kind) and the number of points for star-shaped markers (MarkerBase.StarPointCount).

Note that the color of markers within a point series is specified by the SeriesViewBase.Color property of the series object itself.

An object of the MarkerBase can be accessed via the BubbleSeriesView.BubbleMarkerOptions property of a Bubble series object.

Example

The following example demonstrates how to create a ChartControl with a series of the PointSeriesView type, and add this chart to a form at runtime. Before proceeding with this example, first create a Windows Forms Application in Visual Studio, and include all necessary assemblies to the References list of your project.

Then, add the following code to the Form.Load event handler.

C#

using System;
using System.Windows.Forms;
using DevExpress.XtraCharts;
// ...

private void Form1_Load(object sender, EventArgs e) {
    // Create a new chart.
    ChartControl pointChart = new ChartControl();

    // Create a point series.
    Series series1 = new Series("Series 1", ViewType.Point);

    // Set the numerical argument scale type for the series,
    // as it is qualitative, by default.
    series1.ArgumentScaleType = ScaleType.Numerical;

    // Add points to it.
    series1.Points.Add(new SeriesPoint(1, 10));
    series1.Points.Add(new SeriesPoint(2, 22));
    series1.Points.Add(new SeriesPoint(3, 14));
    series1.Points.Add(new SeriesPoint(4, 27));
    series1.Points.Add(new SeriesPoint(5, 15));
    series1.Points.Add(new SeriesPoint(6, 28));
    series1.Points.Add(new SeriesPoint(7, 15));
    series1.Points.Add(new SeriesPoint(8, 33));

    // Add the series to the chart.
    pointChart.Series.Add(series1);

    // Access the view-type-specific options of the series.
    PointSeriesView myView1 = (PointSeriesView)series1.View;
    myView1.PointMarkerOptions.Kind = MarkerKind.Star;
    myView1.PointMarkerOptions.StarPointCount = 5;
    myView1.PointMarkerOptions.Size = 20;

    // Access the type-specific options of the diagram.
    ((XYDiagram)pointChart.Diagram).EnableAxisXZooming = true;

    // Hide the legend (if necessary).
    pointChart.Legend.Visible = false;

    // Add a title to the chart (if necessary).
    pointChart.Titles.Add(new ChartTitle());
    pointChart.Titles[0].Text = "A Point Chart";

    // Add the chart to the form.
    pointChart.Dock = DockStyle.Fill;
    this.Controls.Add(pointChart);
}

VB.NET

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraCharts
' ...

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _ 
Handles MyBase.Load
    ' Create a new chart.
    Dim pointChart As New ChartControl()

    ' Create a point series.
    Dim series1 As New Series("Series 1", ViewType.Point)

    ' Set the numerical argument scale type for the series,
    ' as it is qualitative, by default.
    series1.ArgumentScaleType = ScaleType.Numerical

    ' Add points to it.
    series1.Points.Add(New SeriesPoint(1, 10))
    series1.Points.Add(New SeriesPoint(2, 22))
    series1.Points.Add(New SeriesPoint(3, 14))
    series1.Points.Add(New SeriesPoint(4, 27))
    series1.Points.Add(New SeriesPoint(5, 15))
    series1.Points.Add(New SeriesPoint(6, 28))
    series1.Points.Add(New SeriesPoint(7, 15))
    series1.Points.Add(New SeriesPoint(8, 33))

    ' Add the series to the chart.
    pointChart.Series.Add(series1)

    ' Access the view-type-specific options of the series.
    Dim myView1 As PointSeriesView = CType(series1.View, PointSeriesView)
    myView1.PointMarkerOptions.Kind = MarkerKind.Star
    myView1.PointMarkerOptions.StarPointCount = 5
    myView1.PointMarkerOptions.Size = 20

    ' Access the type-specific options of the diagram.
    CType(pointChart.Diagram, XYDiagram).EnableAxisXZooming = True

    ' Hide the legend (if necessary).
    pointChart.Legend.Visible = False

    ' Add a title to the chart (if necessary).
    pointChart.Titles.Add(New ChartTitle())
    pointChart.Titles(0).Text = "A Point Chart"

    ' Add the chart to the form.
    pointChart.Dock = DockStyle.Fill
    Me.Controls.Add(pointChart)
End Sub

Inheritance

Object

ChartElement

MarkerBase

SimpleMarker

Marker