RangeAreaSeries

argumentField

Each point in a range-like series has one argument and two values. Arguments are provided by the argumentField; values are provided by the rangeValue1Field and rangeValue2Field.

Commonly, when a chart contains several series, many of them have the same argument field. In this case, assign the name of this field to the argumentField property of the commonSeriesSettings object. If a series must have a unique argument field, specify the same property, but do so in the series object within the series array.

axis

When there are multiple value axes in a chart, series need to know exactly which axis they are bound to. By default, all of them are bound to the first axis in the valueAxis array. To bind a series to another axis, assign the name of the axis to the axis series property.

Declared in commonSeriesSettings, the border settings apply to all series in the chart. Declared in a series configuration object, the border settings apply to this particular series only. The series-specific border settings override the common ones.

hoverMode

When a user points to a series, it may react in one of the following ways depending on the value of the hoverMode option.

hoverMode

Result

"nearestPoint"

"includePoints"

"excludePoints"

"none"

NOTE

Points in range area series are hidden by default. To make them visible, assign true to the point | visible option.

When configuring the widget using ASP.NET MVC Wrappers, specify this option using the ChartSeriesHoverMode enum with one of the following values: NearestPoint, IncludePoints, ExcludePoints, and None. Note that although this enum accepts more values, only the listed ones can be applied to a range area series.

Declared in commonSeriesSettings, hoverStyle applies to all series in the chart. Declared in a series configuration object, hoverStyle applies to this particular series only. The series-specific hoverStyle overrides the common one.

ignoreEmptyPoints

Data points that have the null argument or value do not produce actual series points. Because of this, series of continuous types (line, spline, area, etc.) may be drawn with unnecessary gaps where missing points should have been. To remove these gaps, set the ignoreEmptyPoints option to true.

Declared in commonSeriesSettings, the label settings apply to all point labels in the chart. Declared in a series configuration object, the label settings apply only to the point labels that belong to this particular series. The series-specific label settings override the common ones.

See Also

customizeLabel - сustomizes the appearance of an individual point label.

maxLabelCount

If the number of points in a series increases over time, there comes a time when it becomes so massive that displaying labels for them makes the chart too cluttered. In this instance, to keep the chart clear to the viewer, specify a limit for the number of point labels using the maxLabelCount option. Once this limit is exceeded, all point labels of the series will be hidden.

See Also

Declared in commonSeriesSettings, the point settings apply to all points in the chart. Declared in a series configuration object, the point settings apply only to the points that belong to this particular series. The series-specific point settings override the common ones.

See Also

customizePoint - сustomizes the appearance of an individual series point.

rangeValue1Field

Coupled with the rangeValue2Field option, specifies which data source field provides values for a range-like series.

selectionMode

Though not provided out of the box, the selection capability can be implemented using the widget API. Refer to the onSeriesClick option description for details.

When a user selects a series, it may react in one of the following ways depending on the value of the selectionMode option.

selectionMode

Result

"includePoints"

"excludePoints"

"none"

NOTE

Points in range area series are hidden by default. To make them visible, assign true to the point | visible option.

When configuring the widget using ASP.NET MVC Wrappers, specify this option using the ChartSeriesSelectionMode enum with one of the following values: IncludePoints, ExcludePoints, and None. Note that although this enum accepts more values, only the listed ones can be applied to a range area series.

Though not provided out of the box, the selection capability can be implemented using the widget API. Refer to the onPointClick option description for details.

Declared in commonSeriesSettings, selectionStyle applies to all series in the chart. Declared in a series configuration object, selectionStyle applies to this particular series only. The series-specific selectionStyle overrides the common one.

tagField

This option allows you to associate virtually any required data with a series point. This data will be stored in the tag field of the Point object.

Commonly, a chart contains several series, and many of them have the same tagField value. In this case, specify the tagField property in the commonSeriesSettings object. If a series must have a unique tagField value, specify the same property, but do so in the series object within the series array.