ScaleBreakOptions.SizeInPixels Property

Gets or sets the scale break size.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v24.1.dll

NuGet Package: DevExpress.Wpf.Charts

Declaration

C#

public int SizeInPixels { get; set; }

VB.NET

Public Property SizeInPixels As Integer

Property Value

Type	Description
Int32	The distance between scale break edges, in pixels.

Property Paths

You can access this nested property as listed below:

Object Type	Path to SizeInPixels
Axis2D	.ScaleBreakOptions .SizeInPixels

Remarks

The SizeInPixels property affects all the scale breaks available for an axis (both automatic and manual).

When the SizeInPixels property is specified to a value is equal or less than -1, the scale break edges overlap each other, and a zero value means that their edges contact.

Example

This example shows how to customize the scale break appearance.

To do this, use the following ScaleBreakOptions class properties:

• The ScaleBreakOptions.SizeInPixels property specifies distance between a scale break’s edges.
• The ScaleBreakOptions.Style property defines the appearance of the scale break edges.
• The ScaleBreakOptions.Brush property sets the a scale break edge color.
• The ScaleBreakOptions.LineStyle property specifies parameters of a line that is used to draw scale break edges.

Note that ScaleBreakOptions define the appearance of both manual and automatic scale breaks.

MainWindow.xaml

<dxc:AxisY2D.ScaleBreakOptions>
    <dxc:ScaleBreakOptions SizeInPixels="15" 
                           Style="Waved" 
                           Brush="Gray">
        <dxc:ScaleBreakOptions.LineStyle>
            <dxc:LineStyle Thickness="2"/>
        </dxc:ScaleBreakOptions.LineStyle>
    </dxc:ScaleBreakOptions>
</dxc:AxisY2D.ScaleBreakOptions>