com.sencha.gxt.core.client.gestures

Class CellGestureAdapter<G extends GestureRecognizer,T>

java.lang.Object

com.sencha.gxt.core.client.gestures.CellGestureAdapter<G,T>

Type Parameters:

G - the type of gesture to create and manage

T - the type of data in the cell, so that it can be managed correctly

Direct Known Subclasses:

DragGestureRecognizer.CellDragGestureRecognizer, LongPressOrTapGestureRecognizer.CellLongPressOrTapGestureRecognizer, TapGestureRecognizer.CellTapGestureRecognizer

public abstract class CellGestureAdapter<G extends GestureRecognizer,T>
extends Object

Helper class to build and track gesture instances for use in cells. Subclasses should declare how to actually create the specific gesture they are interested in, and call the #release methods to indicate that the gesture has ended and can be garbage collected.

Constructor Summary

Constructors

Constructor and Description
CellGestureAdapter()

Method Summary

Modifier and Type	Method and Description
protected abstract G	createRecognizer() Creates a new recognizer instance.
Context	getContext(GestureRecognizer gestureRecognizer)
G	getGestureRecognizer(Context context) Gets the gesture recognizer for the given context, if any exists
G	getOrCreateGestureRecognizer(Context context, Element parent, T value, <any> updater) Gets a gesture recognizer for the given context, or creates it using the other provided arguments.
Element	getParent(GestureRecognizer gestureRecognizer)
T	getValue(GestureRecognizer gestureRecognizer)
<any>	getValueUpdater(GestureRecognizer gestureRecognizer)
void	handle(Context context, Element parent, T value, NativeEvent event, <any> updater) Indicates that a new event is occurring in the given rendered cell instance that should potentially should be handled by a gesture recognizer.
void	release(Context context) Indicates that the gesture recognizer for the given cell context is no longer required, and can be garbage collected.
void	setDelegate(HasHandlers delegate)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CellGestureAdapter

public CellGestureAdapter()

Method Detail

createRecognizer

protected abstract G createRecognizer()

Creates a new recognizer instance. This will be called when a rendered cell instance is being interacted with and need to have its events handled correctly.

Returns:

a new instance of the recognizer

handle

public void handle(Context context,
                   Element parent,
                   T value,
                   NativeEvent event,
                   <any> updater)

Indicates that a new event is occurring in the given rendered cell instance that should potentially should be handled by a gesture recognizer.

Parameters:

context - the context of the cell

parent - the parent element of the rendered cell

value - the current value of the cell

event - the event that occurred

updater - a valueupdater to change the cell value

getOrCreateGestureRecognizer

public G getOrCreateGestureRecognizer(Context context,
                                      Element parent,
                                      T value,
                                      <any> updater)

Gets a gesture recognizer for the given context, or creates it using the other provided arguments. Any object returned from this must be correctly released to avoid a memory leak.

Parameters:

context - the context of the cell

parent - the parent element of the rendered cell

value - the current value of the cell

updater - a valueupdater to change the cell value

Returns:

the gesture recognizer for the given rendered cell instance

getGestureRecognizer

public G getGestureRecognizer(Context context)

Gets the gesture recognizer for the given context, if any exists

Parameters:

context - the context of the rendered cell instance

Returns:

the gesture currently associated with that context, or null if non exists

release

public void release(Context context)

Indicates that the gesture recognizer for the given cell context is no longer required, and can be garbage collected. This usually means that the gesture has ended, the gesture was canceled, or the cell was re-rendered and any old gesture is no longer required.

Parameters:

context - the context of the cell that no longer needs this gesture

getParent

public Element getParent(GestureRecognizer gestureRecognizer)

getContext

public Context getContext(GestureRecognizer gestureRecognizer)

getValue

public T getValue(GestureRecognizer gestureRecognizer)

getValueUpdater

public <any> getValueUpdater(GestureRecognizer gestureRecognizer)

setDelegate

public void setDelegate(HasHandlers delegate)