Skip to main content

SeriesBase.TopNOptions Property

Provides access to settings that indicate whether it is required to show only the Top N series points in a series and define the rule to determine the Top N points.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

[PersistenceMode(PersistenceMode.InnerProperty)]
[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
[XtraSerializableProperty(XtraSerializationVisibility.Content)]
public TopNOptions TopNOptions { get; }

Property Value

Type Description
TopNOptions

A TopNOptions object which contains settings of the “Top N” feature.

Remarks

The “Top N” feature is intended to visually display only selected series points in a series, and is determined by the TopNOptions object returned by the TopNOptions property. This feature is applied only if the TopNOptions‘s TopNOptions.Enabled property is set to true.

If this feature is enabled, then the TopNOptions.Mode property specifies the determining property (TopNOptions.Count, TopNOptions.ThresholdValue or TopNOptions.ThresholdPercent) that defines how many series points will be visible in a chart. 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.

Note

The “Top N” feature is in effect only for a series whose data points contain only one value, because this value is used to determine which points to show. So, if data points contain more than one value (e.g., Value and Weight for a Bubble chart or Low, High, Open and Close Financial charts), the “Top N” feature can’t be enabled.

Note

If a series contains data points with negative values, their absolute values are taken into account when calculating which points should be visible within a chart.

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

See Also