TdxChartSeriesTopNOptions.Value Property

Specifies the display criterion for the top N points 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

Use the Value property to change the number of visible series points or the display point threshold value depending on the Mode property value.

Modes and Property Values

The Value property value has different meanings depending on the Mode property value:

TdxChartSeriesTopNOptionsMode.Count

The Value property specifies the number of top visible series values.

TdxChartSeriesTopNOptionsMode.ThresholdPercent

The Value property specifies a threshold value as a percentage. A simple series displays only those values that exceed the threshold.

TdxChartSeriesTopNOptionsMode.ThresholdValue

The Value property specifies a threshold value. A simple series displays only those values that 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.