Range.EndSideMargin Property
Gets or sets the distance between the series point with the highest value and the end of the axis range.
Namespace: DevExpress.XtraCharts
Assembly: DevExpress.XtraCharts.v21.2.dll
Declaration
Property Value
| Type | Description |
|---|---|
| Double | The side margin value, in units specified by SideMarginSizeUnit. |
Remarks
Use the WholeRange and VisualRange properties to access the EndSideMargin property. To specify the margin on the opposite side, use StartSideMargin. Set the Range.SideMarginsValue property to define both side margins.
Specify Margins in Axis Units
The following images show a chart with different EndSideMargin values (the x-axis measurement unit is Hour):
| Property Value | Example |
|---|---|
| WholeRange.EndSideMargin = 5 (Hours) (WholeRange.SideMarginSizeUnit = SideMarginSizeUnit.AxisUnit) |
 |
| WholeRange.EndSideMargin = 0 (Hours) (WholeRange.SideMarginSizeUnit = SideMarginSizeUnit.AxisUnit) |
 |
XYDiagram diagram = chart.Diagram as XYDiagram;
diagram.AxisX.WholeRange.SideMarginSizeUnit = SideMarginSizeUnit.AxisUnit;
diagram.AxisX.WholeRange.EndSideMargin = 5;
Note: If you set EndSideMargin or StartSideMargin, the control ignores the Range.AutoSideMargins property.
When the SideMarginSizeUnit property is set to AxisUnit, side margins are specified in axis measurement units (NumericScaleOptions.MeasureUnit, DateTimeScaleOptions.MeasureUnit, or TimeSpanScaleOptions.MeasureUnit). These axis measurement units vary according to the axis type.
Axis Type | Axis Mode | Default Measurement Unit |
|---|---|---|
Date-time | Continuous | |
Date-time | Automatic, Manual, Interval | |
Time-span | Continuous | |
Time-span | Automatic, Manual, Interval | |
Numerical | Automatic, Continuous, Manual, Interval | |
Qualitative | Ones |
Specify Margins as a Percentage
Set the Range.SideMarginSizeUnit property to SideMarginSizeUnit.AxisRangePercentage to define a margin value as a percentage of the axis range, for example:
XYDiagram diagram = chart.Diagram as XYDiagram;
diagram.AxisX.WholeRange.SideMarginSizeUnit = SideMarginSizeUnit.AxisRangePercentage;
diagram.AxisX.WholeRange.EndSideMargin = 20;
Reversed Axis Margins
If the Axis.Reverse property is enabled (axis values are arranged in reversed order), side margins change their positions. As a result, the end margin is displayed at the left (for an x-axis) or bottom (for a y-axis) of the diagram.
