[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Collapse]Charts Suite
   [Collapse]Chart Control
    [Expand]Getting Started
    [Expand]Providing Data
    [Collapse]Chart Elements
       Primary and Secondary Axes
       Axis Scale Types
       Whole and Visual Ranges
       Axis Layout and Appearance
       Axis Labels
       Axis Titles
       Constant Lines
       Scale Breaks
       Tickmarks, Grid Lines, and Interlacing
      Chart Titles
    [Expand]Appearance Customization
    [Expand]End-User Features
    [Expand]Design-Time Features
    [Expand]Additional Resources
   [Expand]Chart3D Control
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Scale Breaks

The Chart control enables you to create scale breaks along an axis both manually and automatically. Use scale breaks to skip data ranges from a Cartesian diagram's x- and y-axis scales.


At present, scale breaks can't work simultaneously with Zooming and Scrolling (2D XY-Charts). Scrolling has the higher priority. So, in a situation when both scale breaks and scrolling are enabled for any axis of the same diagram, scale breaks will be disabled, while scrolling will persist.

This document consists of the following 'how-to' sections:

Expanded How to Generate Scale Breaks Automatically

The Chart control can automatically insert scale breaks into an axis. Use the following code to auto-create y-axis' scale breaks:

Use the following classes and properties to enable auto-generating scale breaks:

Class or Property Description
Axis2D.AutoScaleBreaks Gets or sets automatic scale breaks.
AutoScaleBreaks The storage of automatic scale breaks' settings.
AutoScaleBreaks.Enabled Specifies whether auto-creating of scale breaks is enabled.
AutoScaleBreaks.MaxCount Limits a maximum possible number of auto-generated scale breaks.

Expanded How to Create Scale Breaks Manually

In addition to automatic scale breaks, you can manually add scale breaks to a chart. For this, populate the Axis2D.ScaleBreaks collection with the ScaleBreak objects and limit each scale break by two edges in axis measurement units. Note that it does not matter in which order scale break edges are defined.

The following code shows how to specify two horizontal scale breaks:

Use the following API members to create scale breaks manually:

Class or Property Description
Axis2D.ScaleBreaks The collection of scale breaks that are added manually.
ScaleBreak An individual scale break.
ScaleBreak.Edge1 Specifies a scale break's first edge. This value should be specified in an appropriate axis's measurement units.
ScaleBreak.Edge2 Specifies a scale break's second edge. This value should be specified in an appropriate axis's measurement units.

Expanded How to Customize Scale Breaks' Appearance

You can modify the appearance of scale breaks (both manual and automatic) in different ways, for example, as the following image shows:

The markup below demonstrates how to change the distance between scale breaks' edges, their thickness, style, and color. Note that ScaleBreakOptions equally affect both manual and automatic scale breaks' appearance.

The following table lists classes and properties that are used to customize scale breaks' appearance.

Class or Property Description
Axis2D.ScaleBreakOptions Gets or set the appearance settings of the axis scale breaks.
ScaleBreakOptions Scale break appearance settings storage.
ScaleBreakOptions.SizeInPixels Specifies the distance between scale break edges.
ScaleBreakOptions.Style Gets or sets the appearance of scale breaks' edges.
ScaleBreakOptions.Brush Specifies the brush to draw the scale break edges.
ScaleBreakOptions.LineStyle Gets or sets the style of the line that is used to draw a scale break.
LineStyle Line settings storage.

Is this topic helpful?​​​​​​​