TopNOptions.ThresholdPercent Property

Gets or sets the percent value which is the minimum limit for values of the Top N series points.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.1.dll

Declaration

public double ThresholdPercent { get; set; }
Public Property ThresholdPercent As Double

Property Value

Type Description
Double

A Double value that represents the minimum percent value. It should be within the range 0;100.

Property Paths

You can access this nested property as listed below:

Object Type Path to ThresholdPercent
Series
.TopNOptions.ThresholdPercent
SeriesBase
.TopNOptions.ThresholdPercent
SeriesTemplate
.TopNOptions.ThresholdPercent

Remarks

The "Top N" feature is intended to visually represent only selected series points in a series, and is determined by the TopNOptions object returned by the SeriesBase.TopNOptions property. This feature is applied only if the SeriesBase.TopNOptions's TopNOptions.Enabled property is set to true.

If this feature is enabled and the TopNOptions.Mode property is set to TopNMode.ThresholdPercent, then the ThresholdPercent property specifies how many series points will be visible in a chart. So, all series points are sorted by their values (in this case, absolute values are taken into account), and only those series points whose value's percent (in respect to the summary of all values) is greater than or equal to the ThresholdPercent property value are visible. All other series points are combined into a single "Others" point, which can be visible or hidden according to the TopNOptions.ShowOthers property value. The text shown as an argument of the "Others" point is specified by the TopNOptions.OthersArgument property.

Also, it is possible to determine the top N visible points by their TopNOptions.Count (if the TopNOptions.Mode property is set to TopNMode.Count) or TopNOptions.ThresholdValue (if the TopNOptions.Mode property is set to TopNMode.ThresholdValue) values.

NOTE

Only one of the TopNOptions.Count, TopNOptions.ThresholdValue or ThresholdPercent properties can be in effect at one time. The currently active property is determined by the top N options' TopNOptions.Mode.

The following image demonstrates how the ThresholdPercent property works.

TopN_1c

For more information, refer to Using The Top-N Feature.

See Also