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

public static final int FROM_THE_START
Range begins with the "lowest" element in the collection.

TO_THE_END

public static final int TO_THE_END
Range ends with the "highest" element in the collection.
Method Detail

apply

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



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.