net.rim.device.api.collection
Interface IntRangedActionTarget

All Known Implementing Classes:

ReadableListCombiner

public interface IntRangedActionTarget

Defines functionality for a collection that supports actions on a range of contained elements with integer keys.

The implementing object can interpret low and high value parameters in any way; however, typically these are used to mark the end points of a range of elements within a sorted list that uses integer keys (such as an IntSortedReadableList).

Field Summary
static int	FROM_THE_START Range begins with the "lowest" element in the collection.
static int	TO_THE_END Range ends with the "highest" element in the collection.

Method Summary
void	apply(int lowValue, int highValue, long action, Object context) Applies an action to a range of elements in this collection.

Field Detail

FROM_THE_START

static final int FROM_THE_START

Range begins with the "lowest" element in the collection.

See Also:

Constant Field Values

TO_THE_END

static final int TO_THE_END

Range ends with the "highest" element in the collection.

See Also:

Constant Field Values

Method Detail

apply

void apply(int lowValue,
           int highValue,
           long action,
           Object context)

Applies an action to a range of elements in this collection.

This method indicates the action to perform with a long value; the implementing collection must understand what this action key denotes.

The invoker can also provide this collection with additional data for use during the bulk action, passing this in the form of a context object.

Parameters:

lowValue - Key for the first element to affect.

highValue - Key for the last element to affect.

action - Action to perform.

context - Contextual data for use during the action.