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.v23.2.dll
NuGet Package: DevExpress.Charts
Declaration
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 |
|---|---|
| SeriesBase |
|
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.
For more information, refer to Using The Top-N Feature.