ScaleBreakOptions.SizeInPixels Property
Gets or sets the size of scale breaks.
Namespace: DevExpress.XtraCharts
Assembly: DevExpress.XtraCharts.v24.2.dll
Declaration
Property Value
| Type | Description |
|---|---|
| Int32 | An integer, representing the distance between the edges of scale breaks, in pixels. It should be greater than or equal to -1 and less than 50. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to SizeInPixels |
|---|---|
| Axis |
|
Remarks
Note that the SizeInPixels property simultaneously affects all the scale breaks available for an axis (both automatic and manual).
The following images demonstrate the SizeInPixels property in action.
| SizeInPixels = 5 | SizeInPixels = 20 |
|---|---|
 |
 |
Note that if the SizeInPixels property is set to -1, the edges of the scale breaks will overlap, and a zero value means that their edges will meet.
In addition, to adjust the appearance of a scale break, you can use the following properties: ScaleBreakOptions.Style 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.
// 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;