MarkerBase.Kind Property

Gets or sets the shape of markers.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v23.2.dll

NuGet Package: DevExpress.Charts

Declaration

C#

public MarkerKind Kind { get; set; }

VB.NET

Public Property Kind As MarkerKind

Property Value

Type	Description
MarkerKind	A MarkerKind enumeration value.

Available values:

Show 11 items

Name	Description
Square	Specifies a square marker.
Diamond	Specifies a diamond-shaped marker.
Triangle	Specifies a triangular marker.
InvertedTriangle	Specifies an inverted triangle marker.
Circle	Specifies a circular marker.
Plus	Specifies a plus-shaped marker.
Cross	Specifies a cross-shaped marker.
Star	Specifies a star-shaped marker.
Pentagon	Specifies a pentagonal marker.
Hexagon	Specifies a hexagonal marker.
ThinCross	Specifies a thin cross-shaped marker.

Remarks

Use the Kind property to specify the shape of the markers which can be displayed by point and line series and within the chart control’s legend.

Note that if the Kind property is set to the MarkerKind.Star value, the number of star points can be specified by the MarkerBase.StarPointCount property.

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

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Kind property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-charts-create-line-chart/CS/Series_LineChart/Form1.cs#L36

((LineSeriesView)series1.View).LineMarkerOptions.Size = 20;
((LineSeriesView)series1.View).LineMarkerOptions.Kind = MarkerKind.Triangle;
((LineSeriesView)series1.View).LineStyle.DashStyle = DashStyle.Dash;

VB.NET

winforms-charts-create-line-chart/VB/Series_LineChart/Form1.vb#L34

CType(series1.View, LineSeriesView).LineMarkerOptions.Size = 20
CType(series1.View, LineSeriesView).LineMarkerOptions.Kind = MarkerKind.Triangle
CType(series1.View, LineSeriesView).LineStyle.DashStyle = DashStyle.Dash