Skip to main content

TdxChartSeriesTopNOptions.Mode Property

Specifies the calculation mode of point visibility criteria.

Declaration

property Mode: TdxChartSeriesTopNOptionsMode read; write; default TdxChartSeriesTopNOptionsMode.Count;

Property Value

Type Default Description
TdxChartSeriesTopNOptionsMode Count

The active Top N values display mode.

Remarks

If a simple series includes multiple points with low values, you may want to reduce their quantity to emphasize the most important points.

Mode and Value properties determine what points the parent series displays as separate slices if the Enabled property is set to True. The series displays all other points as an aggregate slice if the ShowOthers property is set to True (default).

Examples

Top N is Disabled

This example demonstrates the same series with all points for comparison.

VCL Chart Control: The Top N Mode is Disabled

Count Mode

Default Mode. A simple series displays a number of first points as separate slices according to their order in the Series.Points collection if series points are unsorted. The Value property specifies the number of separate slices.

Note

The current sort order defines what series points are displayed as separate slices in this mode.

In this example, the Series.SortBy property is set to TdxChartSeriesSortBy.Value, and the Series.SortOrder property is set to to soDescending to display the points with highest values as separate slices.

VCL Chart Control: A Doughnut Series in Count Mode

Relative Threshold Mode

All series points whose values exceed Value (as a percentage)[1] are displayed as separate slices.

VCL Chart Control: A Doughnut Series in Relative Threshold Mode

Absolute Threshold Mode

All series points whose values exceed Value[2] are displayed as separate slices.

VCL Chart Control: A Doughnut Series in Absolute Threshold Mode

Refer to the TdxChartSeriesTopNOptionsMode type description for additional information on all available options.

Default Value

The Mode property’s default value is TdxChartSeriesTopNOptionsMode.Count.

Footnotes
  1. The Value property is set to 10 (default).

  2. The Value property is set to 50 (default).

See Also