Skip to main content

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

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

The following members return MarkerBase objects:

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.

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);
}

Inheritance

See Also