ScaleBreakOptions.SizeInPixels Property
Gets or sets the size of scale breaks.
Namespace: DevExpress.XtraCharts
Assembly: DevExpress.XtraCharts.v20.2.dll
NuGet Packages: DevExpress.Charts, DevExpress.WindowsDesktop.Charts
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 |
|
| AxisX |
|
| AxisXBase |
|
| AxisY |
|
| AxisYBase |
|
| GanttAxisX |
|
| SecondaryAxisX |
|
| SecondaryAxisY |
|
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;
Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the SizeInPixels 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.