net.rim.device.api.collection
Interface LongRangedActionTarget

All Known Implementing Classes:

ReadableListCombiner

public interface LongRangedActionTarget

Defines functionality for a collection that supports actions on a range of contained elements with long 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 a LongSortedReadableList).

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

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

Field Detail

FROM_THE_START

static final long FROM_THE_START

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

See Also:

Constant Field Values

TO_THE_END

static final long TO_THE_END

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

See Also:

Constant Field Values

Method Detail

apply

void apply(long lowValue,
           long 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.