Skip to main content
All docs
V25.2
  • 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