Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

ScaleBreakOptions.SizeInPixels Property

Gets or sets the scale break size.

Namespace: DevExpress.Xpf.Charts

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

NuGet Package: DevExpress.Wpf.Charts

#Declaration

public int SizeInPixels { get; set; }

#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.

<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>
See Also