TdxChartSeriesTopNOptions.Value Property

Specifies the display criterion for points displayed as separate slices in a simple series.

Declaration

property Value: Double read; write;

Property Value

Type	Description
Double	A simple series interprets this property value differently depending on the Mode property value. Refer to the following help topic section for details: Modes and Property Values. The property setter behavior and default values also depend on the Mode property value. Refer to the following help topic sections for details: Property Setter Behavior Default Value

Remarks

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).

Modes and Property Values

The parent series interprets the Value property differently depending on the Mode property value:

TdxChartSeriesTopNOptionsMode.Count

The Value property specifies the number of first visible series values as separate slices.

Note

The current sort order defines the series point display order. For example, you need to set the Series.SortBy property to TdxChartSeriesSortBy.Value, and the Series.SortOrder property to soDescending to display the points with highest values as separate slices.

TdxChartSeriesTopNOptionsMode.ThresholdPercent

The Value property specifies a relative threshold value (as a percentage). The parent series displays only those points whose values exceed the threshold.

TdxChartSeriesTopNOptionsMode.ThresholdValue

The Value property specifies an absolute threshold value. The parent series displays only those points whose values exceed the threshold.

Property Setter Behavior

The Value property setter behaves differently depending on the Mode property value:

TdxChartSeriesTopNOptionsMode.Count

The property value can be 1 or higher. If you assign a non-integer value to the Value property, the property setter truncates the fractional part.

TdxChartSeriesTopNOptionsMode.ThresholdPercent

The property value can be within the range between MinDouble and 100.

TdxChartSeriesTopNOptionsMode.ThresholdValue

The Value property setter imposes no limitations on assigned values in this mode.

Default Value

Different Mode property values define different default values for the Value property. Every Mode property value change resets the Value property to the corresponding default value:

TdxChartSeriesTopNOptionsMode.Count

The Value property’s default value is 5.

TdxChartSeriesTopNOptionsMode.ThresholdPercent

The Value property’s default value is 10.

TdxChartSeriesTopNOptionsMode.ThresholdValue

The Value property’s default value is 50.