New to Telerik UI for WinForms? Start a free 30-day trial

RangeMapper

Class

Base class that maps item indices onto a fixed-size collection, supporting circular (looping) or restricted (clamped) index arithmetic used by the carousel's virtualization.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

public abstract class RangeMapper

Inheritance: objectRangeMapper

Derived Classes: CircularRangeMapperRestrictedRangeMapper

Constructors

RangeMapper()

protected RangeMapper()

Properties

ItemsCount

int

Gets or sets the total number of items the mapper wraps or clamps indices against.

public int ItemsCount { get; set; }

Methods

Closest(int, int)

Resolves which wrapped occurrence of newValue is numerically closest to curVal.

public abstract int Closest(int curVal, int newValue)

Parameters:curValintnewValueintReturns:

int

CreateLeft(Range, Range)

Creates the portion of the target range that lies before the source range's lower bound.

public Range CreateLeft(Range target, Range source)

Parameters:targetRangesourceRangeReturns:

Range

CreateRight(Range, Range)

Creates the portion of the target range that lies after the source range's upper bound.

public Range CreateRight(Range target, Range source)

Parameters:targetRangesourceRangeReturns:

Range

IsInRange(Range, int)

Determines whether the specified index falls within the range, accounting for wrap-around.

public abstract bool IsInRange(Range range, int index)

Parameters:rangeRangeindexintReturns:

bool

MapFromRangeIndex(int)

Converts an index that may fall outside 0..ItemsCount-1 into a valid item index according to the mapper's wrapping strategy.

public abstract int MapFromRangeIndex(int index)

Parameters:indexintReturns:

int

Normalize(Range, int)

Adjusts the specified index so it falls within the given range, wrapping by multiples of ItemsCount if needed.

public abstract int Normalize(Range range, int index)

Parameters:rangeRangeindexintReturns:

int

Normalize(Range)

Adjusts the specified range so its bounds are consistent with ItemsCount.

public abstract Range Normalize(Range source)

Parameters:sourceRangeReturns:

Range