public final class TouchEvent extends InputEvent
Touch point represents a single touched finger and has its location,
state (pressed/moved/released/stationary) and an ID unique in scope of a
single gesture. For detailed reference see TouchPoint
.
For each multi-touch action a set of touch events is generated - for each
touch point one. The event has type corresponds to its touch point's state.
Each of the events also contain
list of all the touch points. This design allows for handling complicated
multi-touch actions from one place while keeping it possible to
filter/consume each touch point separately. To recognize
which events belong into a single set there is getEventSetId()
method.
Each touch point is - similarly to mouse dragging - delivered to a single
node on which it was pressed, regardless of where it moves then. It is
possible to change this behavior by using a grabbing mechanism described
in TouchPoint
documentation.
Modifier and Type | Field and Description |
---|---|
static EventType<TouchEvent> |
ANY
Common supertype for all touch event types.
|
static EventType<TouchEvent> |
TOUCH_MOVED
This event occurs when the touch point is moved.
|
static EventType<TouchEvent> |
TOUCH_PRESSED
This event occurs when the touch point is pressed (touched for the
first time).
|
static EventType<TouchEvent> |
TOUCH_RELEASED
This event occurs when the touch point is released.
|
static EventType<TouchEvent> |
TOUCH_STATIONARY
This event occurs when the touch point is pressed and still (doesn't
move).
|
consumed, eventType, NULL_SOURCE_TARGET, target
Modifier and Type | Method and Description |
---|---|
Event |
copyFor(java.lang.Object newSource,
EventTarget newTarget)
Creates and returns a copy of this event with the specified event source
and target.
|
int |
getEventSetId()
Gets sequential number of the set of touch events representing the same
multi-touch action.
|
int |
getTouchCount()
Returns number of touch points represented by this touch event set.
|
TouchPoint |
getTouchPoint()
Gets the touch point of this event.
|
java.util.List<TouchPoint> |
getTouchPoints()
Gets all the touch points represented by this set of touch events,
including the touch point of this event.
|
boolean |
isAltDown()
Whether or not the Alt modifier is down on this event.
|
boolean |
isControlDown()
Whether or not the Control modifier is down on this event.
|
boolean |
isMetaDown()
Whether or not the Meta modifier is down on this event.
|
boolean |
isShiftDown()
Whether or not the Shift modifier is down on this event.
|
java.lang.String |
toString()
Returns a string representation of this
TouchEvent object. |
clone, consume, fireEvent, getEventType, getTarget, isConsumed
public static final EventType<TouchEvent> ANY
public static final EventType<TouchEvent> TOUCH_PRESSED
public static final EventType<TouchEvent> TOUCH_MOVED
public static final EventType<TouchEvent> TOUCH_RELEASED
public static final EventType<TouchEvent> TOUCH_STATIONARY
public int getTouchCount()
touchPoints
list.public Event copyFor(java.lang.Object newSource, EventTarget newTarget)
Event
null
, it is
replaced by the NULL_SOURCE_TARGET
value.public final int getEventSetId()
public final boolean isShiftDown()
public final boolean isControlDown()
public final boolean isAltDown()
public final boolean isMetaDown()
public TouchPoint getTouchPoint()
public java.util.List<TouchPoint> getTouchPoints()
belongsTo
method can be used.public java.lang.String toString()
TouchEvent
object.toString
in class java.util.EventObject
TouchEvent
object.Copyright (c) 2008, 2014, Oracle and/or its affiliates. All rights reserved.