Back to Devexpress

ChartRangeControlClientGridOptions.SnapMode Property

corelibraries-devexpress-dot-xtracharts-dot-chartrangecontrolclientgridoptions-66f804a4.md

latest5.4 KB
Original Source

ChartRangeControlClientGridOptions.SnapMode Property

Specifies the current snap mode of a chart range control client.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

csharp
public ChartRangeControlClientSnapMode SnapMode { get; set; }
vb
Public Property SnapMode As ChartRangeControlClientSnapMode

Property Value

TypeDescription
ChartRangeControlClientSnapMode

A ChartRangeControlClientSnapMode enumeration value, which selects one of the modes.

|

Available values:

NameDescription
Auto

Identifies the auto snap mode of the chart range control client, in which the values of ChartRangeControlClientGridOptions.SnapSpacing, ChartRangeControlClientGridOptions.SnapOffset, and ChartRangeControlClientDateTimeGridOptions.SnapAlignment properties are not specified and calculated according to the values of the corresponding ChartRangeControlClientGridOptions.GridSpacing, ChartRangeControlClientGridOptions.GridOffset and ChartRangeControlClientDateTimeGridOptions.GridAlignment properties.

In the image below, the SnapSpacing = GridSpacing = 4.

| | ChartMeasureUnit |

Identifies the chart measure unit mode of the chart range control client, in which the ChartRangeControlClientDateTimeGridOptions.SnapAlignment property is not specified and calculated according to the DateTimeScaleOptions.MeasureUnit (NumericScaleOptions.MeasureUnit) property. Note that the values of the ChartRangeControlClientGridOptions.SnapSpacing and ChartRangeControlClientGridOptions.SnapOffset properties should be equal to the default value.

For example, in the image below, the DateTimeScaleOptions.MeasureUnit property is set to Week.

| | Manual |

Identifies the manual snap mode of the chart range control client, meaning that the ChartRangeControlClientGridOptions.SnapSpacing, ChartRangeControlClientGridOptions.SnapOffset and ChartRangeControlClientDateTimeGridOptions.SnapAlignment properties are in effect, and they should be manually defined.

For example, in the image below, the ChartRangeControlClientGridOptions.SnapSpacing property is set to 6.

|

Remarks

Use the SnapMode property to define which snap mode of the chart range control client should be used: manual, automatic or chart measure unit.

Note that if you defined one of the ChartRangeControlClientGridOptions.SnapSpacing, ChartRangeControlClientGridOptions.SnapOffset or ChartRangeControlClientDateTimeGridOptions.SnapAlignment properties in the ChartRangeControlClientSnapMode.Auto snap mode, this mode is changed to ChartRangeControlClientSnapMode.Manual.

See Also

ChartRangeControlClientGridOptions Class

ChartRangeControlClientGridOptions Members

DevExpress.XtraCharts Namespace