Back to Devexpress

How to: Customize Axis Gridlines and Tickmarks

windowsforms-6181-controls-and-libraries-chart-control-examples-creating-charts-appearance-customization-how-to-customize-axis-gridlines-and-tickmarks.md

latest5.0 KB
Original Source

How to: Customize Axis Gridlines and Tickmarks

  • Mar 11, 2020
  • 2 minutes to read

This example demonstrates how to enable and customize axis grid lines and tickmarks at runtime.

To access an axis, cast the chart’s diagram object to the diagram type (for example, XYDiagram). Use the Axis2D.Tickmarks and AxisBase.GridLines properties to access tickmark and gridline settings.

csharp
using System.Drawing;
using DevExpress.XtraCharts;
//...
// Cast the chart's diagram to the XYDiagram type, to access its axes.
XYDiagram diagram = (XYDiagram)chartControl1.Diagram;

// Customize the appearance of the axes' tickmarks.
diagram.AxisX.Tickmarks.CrossAxis = true;
diagram.AxisX.Tickmarks.Length = 5;
diagram.AxisX.Tickmarks.Thickness = 2;

diagram.AxisY.Tickmarks.Visible = false;
diagram.AxisY.Tickmarks.MinorVisible = false;

diagram.AxisX.Tickmarks.MinorLength = 3;
diagram.AxisX.Tickmarks.MinorThickness = 1;

diagram.AxisX.MinorCount = 2;
diagram.AxisY.MinorCount = 4;

// Customize the appearance of the axes' grid lines.
diagram.AxisX.GridLines.Visible = false;
diagram.AxisX.GridLines.MinorVisible = false;

diagram.AxisY.GridLines.Visible = true;
diagram.AxisY.GridLines.MinorVisible = true;

diagram.AxisY.GridLines.Color = Color.Red;
diagram.AxisY.GridLines.LineStyle.DashStyle = DashStyle.Solid;
diagram.AxisY.GridLines.LineStyle.Thickness = 2;

diagram.AxisY.GridLines.MinorColor = Color.Blue;
diagram.AxisY.GridLines.MinorLineStyle.DashStyle = DashStyle.Dash;
diagram.AxisY.GridLines.MinorLineStyle.Thickness = 1;
vb
Imports System.Drawing
Imports DevExpress.XtraCharts
'...
' Cast the chart's diagram to the XYDiagram type, to access its axes.
Dim diagram As XYDiagram = CType(chartControl1.Diagram, XYDiagram)

' Customize the appearance of the axes' tickmarks.
diagram.AxisX.Tickmarks.CrossAxis = True
diagram.AxisX.Tickmarks.Length = 5
diagram.AxisX.Tickmarks.Thickness = 2

diagram.AxisY.Tickmarks.Visible = False
diagram.AxisY.Tickmarks.MinorVisible = False

diagram.AxisX.Tickmarks.MinorLength = 3
diagram.AxisX.Tickmarks.MinorThickness = 1

diagram.AxisX.MinorCount = 2
diagram.AxisY.MinorCount = 4

' Customize the appearance of the axes' grid lines.
diagram.AxisX.GridLines.Visible = False
diagram.AxisX.GridLines.MinorVisible = False

diagram.AxisY.GridLines.Visible = True
diagram.AxisY.GridLines.MinorVisible = True

diagram.AxisY.GridLines.Color = Color.Red
diagram.AxisY.GridLines.LineStyle.DashStyle = DashStyle.Solid
diagram.AxisY.GridLines.LineStyle.Thickness = 2

diagram.AxisY.GridLines.MinorColor = Color.Blue
diagram.AxisY.GridLines.MinorLineStyle.DashStyle = DashStyle.Dash
diagram.AxisY.GridLines.MinorLineStyle.Thickness = 1

Related API members:

|

Name

|

Description

| | --- | --- | |

AxisBase.MinorCount

|

Defines the number of minor tickmarks (gridlines) between major tickmarks (gridlines).

| |

TickmarksBase.MinorVisible

|

Enables minor tickmarks.

| |

TickmarksBase.CrossAxis

|

Specifies whether tickmarks cross the axis.

| |

TickmarksBase.Length

|

Sets the length of major tickmarks.

| |

TickmarksBase.Thickness

|

Specifies the thickness of major tickmarks.

| |

TickmarksBase.MinorLength

|

Sets the length of minor tickmarks.

| |

TickmarksBase.MinorThickness

|

Specifies the thickness of minor tickmarks.

| |

GridLines.MinorVisible

|

Enables minor gridlines.

| |

GridLines.Color

|

Sets the major gridline color.

| |

GridLines.LineStyle

|

Sets the major gridline style.

| |

GridLines.MinorColor

|

Sets the minor gridline color.

| |

GridLines.MinorLineStyle

|

Specifies the minor gridline style.

|

See Also

Grid Lines, Tickmarks and Interlacing