|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object | +--net.rim.device.api.ui.TouchGesture
TouchGesture contains a set of basic touch input events originating from
the user. TouchGesture events are acquired using TouchEvent.getGesture() when a gesture is detected.
TouchGesture currently defines four common gestures: CLICK_REPEAT, HOVER, SWIPE,
and TAP. TouchGesture objects are immutable, and can be
cached.
| Field Summary | ||
static int |
CLICK_REPEAT
Click and pause at a specific point on the touchscreen for more than 500 milliseconds. |
|
static int |
HOVER
Touch and pause at a specific point on the touchscreen for more than 100 milliseconds. |
|
static int |
SWIPE
Quick motion gesture across the touchscreen. |
|
static int |
SWIPE_EAST
Gesture direction equivalent that is to 0 degrees +/- 45 degrees relative to the device's current upward direction. |
|
static int |
SWIPE_NORTH
Gesture direction that is equivalent to 90 degrees +/- 45 degrees relative to the device's current upward direction. |
|
static int |
SWIPE_SOUTH
Gesture direction that is equivalent to 270 degrees +/- 45 degrees relative to the device's current upward direction. |
|
static int |
SWIPE_WEST
Gesture direction that is equivalent to 180 degrees +/- 45 degrees relative to the device's current upward direction. |
|
static int |
TAP
Quick touch and release gesture on the touchscreen. |
|
| Method Summary | ||
int |
getClickRepeatCount()
Retrieves the number of CLICK_REPEAT events generated before the user moves or releases from the touchscreen. |
|
abstract int |
getEvent()
Retrieves the event code associated with this touch gesture. |
|
int |
getHoverCount()
Retrieves the number of HOVER events generated before the user moves or removes touch from the touchscreen. |
|
int |
getSwipeAngle()
Retrieves the angle (in degrees) associated with a swipe gesture relative to the device's current upward direction. |
|
int |
getSwipeDirection()
Retrieves the relative cardinal direction associated with a swipe gesture based on the device's upward direction. |
|
int |
getSwipeMagnitude()
Retrieves the magnitude (in pixels) associated with a swipe gesture. |
|
int |
getTapCount()
Retrieves the consecutive number of TAP events generated before the user moves or maintains touch for greater than 150 milliseconds. |
|
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
public static final int CLICK_REPEAT
getClickRepeatCount() to retrieve the number of generated consecutive CLICK_REPEAT events.public static final int HOVER
getHoverCount() to retrieve the number of consecutive HOVER events.
.public static final int SWIPE
getSwipeAngle() and getSwipeMagnitude() to retrieve the angle and magnitude of the swipe, respectively.
Invoke getSwipeDirection() to retrieve the cardinal direction of the swipe.public static final int SWIPE_EAST
getSwipeAngle() and getSwipeDirection().public static final int SWIPE_NORTH
getSwipeAngle() and getSwipeDirection().public static final int SWIPE_SOUTH
getSwipeAngle() and getSwipeDirection().public static final int SWIPE_WEST
getSwipeAngle() and getSwipeDirection().public static final int TAP
TouchEvent.UP events if TouchEvent.UP follows
TouchEvent.DOWN. Applications may alternatively choose to respond to TouchEvent.UP using other gesture events. Invoke
getTapCount() to retrieve the number of consecutive taps (for example, double-tap or triple-tap).| Method Detail |
public int getClickRepeatCount()
public abstract int getEvent()
HOVER, SWIPE,
CLICK_REPEAT, or TAP.public int getHoverCount()
public int getSwipeAngle()
public int getSwipeDirection()
SWIPE_NORTH always refers
to the side of the display closest to the top of the device. Swipe gestures
that occur at 90 degree intervals (North, South, West, East) are +/- ~23 degrees.
For example, SWIPE_NORTH is returned for (67, 112], where 67 is exclusive,
and 112 is inclusive. For swipe gestures occurring at a 45 degree interval +/-
~23 degrees, the two directions are bitwise ORed, so 135 degrees returns
SWIPE_NORTH | SWIPE_WEST.
SWIPE_NORTH, SWIPE_SOUTH, SWIPE_EAST,
SWIPE_WEST, or a bitwise ORed combination of two swipe events.public int getSwipeMagnitude()
public int getTapCount()
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
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.