TdxRangeControlCustomClientProperties.GetNextNormalizedAcceptableValue(Double,Variant,Boolean) Method

Returns the viewport position of a value separated from the specified viewport position by a specific data range.

Declaration

function GetNextNormalizedAcceptableValue(const AValue: Double; const AInterval: Variant; out AIsOverflow: Boolean): Double; virtual;

Parameters

Name	Type
AValue	Double
AInterval	Variant
AIsOverflow	Boolean

Returns

Type
Double

Remarks

Normally, this function supports the internal infrastructure and is not intended to be used directly from your code. The GetNextNormalizedAcceptableValue function is called internally by the range control to identify a viewport coordinate of the next scale tickmark or selectable value. This function is called to ensure that:

• A valid upper boundary of the data range is selected;

• All the painted tickmarks correspond to valid (i.e., selectable) scale values.

The AValue parameter is used to pass the “origin” point’s position within the range control’s viewport.

The AInterval parameter is used to pass the distance (using the current scale’s numeric values or measurement units, depending on the actual data range model) between the “origin” and “destination” points.

The AIsOverflow parameter returns a value indicating whether the supposed “destination” point lies outside the selectable range. If AIsOverflow returns True, the GetNextNormalizedAcceptable function returns the viewport coordinate of the maximum selectable value on the scale.