Skip to main content

TopNOptions.Enabled Property

Gets or sets a value indicating whether it is required to show only the Top N series points in a series.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

[TypeConverter(typeof(BooleanTypeConverter))]
[XtraSerializableProperty]
public bool Enabled { get; set; }

Property Value

Type Description
Boolean

true, to show only the Top N series points; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type Path to Enabled
SeriesBase
.TopNOptions .Enabled

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 applicable only if the SeriesBase.TopNOptions‘s Enabled property is set to true.

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

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

See Also