Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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

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

See Also