ScaleBreakOptions.Style Property

Gets or sets a style in which scale breaks‘ edges are drawn.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v22.2.dll

NuGet Package: DevExpress.Charts

Declaration

C#

public ScaleBreakStyle Style { get; set; }

VB.NET

Public Property Style As ScaleBreakStyle

Property Value

Type	Description
ScaleBreakStyle	A ScaleBreakStyle object, which represents the scale break edge style.

Available values:

Name	Description
Straight	Indentifies the straight style of scale breaks edges.
Ragged	Indentifies the ragged style of scale breaks edges.
Waved	Indentifies the wavy style of scale breaks edges.

Property Paths

You can access this nested property as listed below:

Object Type	Path to Style
Axis	.ScaleBreakOptions .Style

Remarks

Note that the Style property simultaneously affects all the scale breaks available for an axis (both automatic and manual).

In addition, to adjust scale breaks appearance, you can use the following properties: ScaleBreakOptions.SizeInPixels and ScaleBreakOptions.Color.

For more information, refer to Scale Breaks.

Example

This example demonstrates how scale breaks can be created within an axis, and customized at runtime.

C#

// Cast your diagram object to an appropriate diagram type,
// to access its axes.
XYDiagram diagram = (XYDiagram)chartControl1.Diagram;

// Add scale breaks to the Y-axis collection, 
// with their Edge1 and Edge2 properties defined in the constructor.
diagram.AxisY.ScaleBreaks.Add(new ScaleBreak("Scale Break 1", 10, 100));
diagram.AxisY.ScaleBreaks.Add(new ScaleBreak("Scale Break 2", 110, 2000));

// Define the scale breaks' options.
diagram.AxisY.ScaleBreakOptions.Style = ScaleBreakStyle.Ragged;
diagram.AxisY.ScaleBreakOptions.SizeInPixels = 20;
diagram.AxisY.ScaleBreakOptions.Color = Color.Turquoise;

VB.NET

' Cast your diagram object to an appropriate diagram type,
' to access its axes.
Dim diagram As XYDiagram = CType(chartControl1.Diagram, XYDiagram)

' Add scale breaks to the Y-axis collection, 
' with their Edge1 and Edge2 properties defined in the constructor.
diagram.AxisY.ScaleBreaks.Add(New ScaleBreak("Scale Break 1", 10, 100))
diagram.AxisY.ScaleBreaks.Add(New ScaleBreak("Scale Break 2", 110, 2000))

' Define the scale breaks' options.
diagram.AxisY.ScaleBreakOptions.Style = ScaleBreakStyle.Ragged
diagram.AxisY.ScaleBreakOptions.SizeInPixels = 20
diagram.AxisY.ScaleBreakOptions.Color = Color.Turquoise

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Style 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#

how-to-enable-automatic-scale-breaks-for-an-axis-e1621/CS/UseScaleBreaks/Form1.cs#L24

// for both manual and automatic scale breaks.
diagram.AxisY.ScaleBreakOptions.Style = ScaleBreakStyle.Waved;
diagram.AxisY.ScaleBreakOptions.SizeInPixels = 30;

how-to-insert-a-scale-break-into-an-axis-e1493/CS/UseScaleBreaks/Form1.cs#L47

// Define the scale breaks' options.
((XYDiagram)chartControl1.Diagram).AxisY.ScaleBreakOptions.Style = ScaleBreakStyle.Waved;
((XYDiagram)chartControl1.Diagram).AxisY.ScaleBreakOptions.SizeInPixels = 20;

VB.NET

how-to-enable-automatic-scale-breaks-for-an-axis-e1621/VB/UseScaleBreaks/Form1.vb#L26

' for both manual and automatic scale breaks.
diagram.AxisY.ScaleBreakOptions.Style = ScaleBreakStyle.Waved
diagram.AxisY.ScaleBreakOptions.SizeInPixels = 30

how-to-insert-a-scale-break-into-an-axis-e1493/VB/UseScaleBreaks/Form1.vb#L46

' Define the scale breaks' options.
CType(chartControl1.Diagram, XYDiagram).AxisY.ScaleBreakOptions.Style = ScaleBreakStyle.Waved
CType(chartControl1.Diagram, XYDiagram).AxisY.ScaleBreakOptions.SizeInPixels = 20