TouchPoint (JavaFX 2.2)

java.lang.Object
- javafx.scene.input.TouchPoint

```
public final class TouchPoint
extends java.lang.Object
```
Touch point represents a single point of a multi-touch action, typically one finger touching a screen. It is contained in TouchEvent.
The touch point has its coordinates, state (see TouchPoint.State) and ID. The ID is sequential number of this touch point unique in scope of a single multi-touch gesture.
Each touch point is by default delivered to a single node during its whole trajectory - to the node on which it was pressed. There is a grabbing API to modify this behavior. The above means that when touch point is pressed, it is automatically grabbed by the top-most node on the press coordinates. Any time during the gesture grab() and ungrab() methods can be used to alter the event delivery target. When grabbed by a different node, it will next time be targeted to it; when ungrabbed, it will be always targeted to the top-most node on the current location.

Since:

2.2

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class TouchPoint.State
Represents current state of the touch point

Nested Classes
Modifier and Type	Class and Description
`static class`	`TouchPoint.State` Represents current state of the touch point

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`belongsTo(EventTarget target)` Distinguishes between touch points targeted to the given node or some of its children from touch points targeted somewhere else.
`EventTarget`	`getGrabbed()` Gets event target which has grabbed this touch point.
`int`	`getId()` Gets identifier of this touch point.
`double`	`getSceneX()` Gets the horizontal position of the touch point relative to the origin of the `Scene` that contains the TouchEvent's source.
`double`	`getSceneY()` Gets the vertical position of the touch point relative to the origin of the `Scene` that contains the TouchEvent's source.
`double`	`getScreenX()` Gets the absolute horizontal position of the touch point.
`double`	`getScreenY()` Gets the absolute vertical position of the touch point.
`TouchPoint.State`	`getState()` Gets state of this touch point
`EventTarget`	`getTarget()` Gets event target on which the touch event carrying this touch point is fired.
`double`	`getX()` Gets the horizontal position of the touch point relative to the origin of the TouchEvent's source.
`double`	`getY()` Gets the vertical position of the touch point relative to the origin of the TouchEvent's source.
`void`	`grab()` Grabs this touch point by current event source.
`void`	`grab(EventTarget target)` Grabs this touch point by the given target.
`java.lang.String`	`toString()` Returns a string representation of this `TouchPoint` object.
`void`	`ungrab()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Method Detail
  - belongsTo
```
public boolean belongsTo(EventTarget target)
```
    Distinguishes between touch points targeted to the given node or some of its children from touch points targeted somewhere else. This allows for testing all touch points carried by one touch event on their relevance for a given node.
    
    Parameters:
    target - Node or other event target to be tested
    
    Returns:
    true if this touch point is targeted to the given target or some of its children
  - getGrabbed
```
public EventTarget getGrabbed()
```
    Gets event target which has grabbed this touch point.
    
    Returns:
    The current grabbed target, null if the touch point is ungrabbed
  - grab
```
public void grab()
```
    Grabs this touch point by current event source. Next event containing this touch point will be targeted to the same node whose event handler called this method.
  - grab
```
public void grab(EventTarget target)
```
    Grabs this touch point by the given target. Next event containing this touch point will be targeted to it.
    
    Parameters:
    target - Target by which to grab the touch point
  - ungrab
```
public void ungrab()
```
  - getId
```
public final int getId()
```
    Gets identifier of this touch point. The number is sequential and unique in scope of one multi touch gesture. The first pressed touch point has id 1, each subsequently pressed touch points gets the next ordinal number until all touch points are released and the counter is reset.
    
    Returns:
    the identifier of this touch point.
  - getState
```
public final TouchPoint.State getState()
```
    Gets state of this touch point
    
    Returns:
    state of this touch point
  - getX
```
public final double getX()
```
    Gets the horizontal position of the touch point relative to the origin of the TouchEvent's source.
    
    Returns:
    the horizontal position of the touch point relative to the origin of the TouchEvent's source.
  - getY
```
public final double getY()
```
    Gets the vertical position of the touch point relative to the origin of the TouchEvent's source.
    
    Returns:
    the vertical position of the touch point relative to the origin of the TouchEvent's source.
  - getScreenX
```
public final double getScreenX()
```
    Gets the absolute horizontal position of the touch point.
    
    Returns:
    the absolute horizontal position of the touch point
  - getScreenY
```
public final double getScreenY()
```
    Gets the absolute vertical position of the touch point.
    
    Returns:
    the absolute vertical position of the touch point
  - getSceneX
```
public final double getSceneX()
```
    Gets the horizontal position of the touch point relative to the origin of the Scene that contains the TouchEvent's source. If the node is not in a Scene, then the value is relative to the boundsInParent of the root-most parent of the TouchEvent's node.
    
    Returns:
    the horizontal position of the touch point relative to the origin of the Scene that contains the TouchEvent's source
  - getSceneY
```
public final double getSceneY()
```
    Gets the vertical position of the touch point relative to the origin of the Scene that contains the TouchEvent's source. If the node is not in a Scene, then the value is relative to the boundsInParent of the root-most parent of the TouchEvent's node.
    
    Returns:
    the vertical position of the touch point relative to the origin of the Scene that contains the TouchEvent's source
  - getTarget
```
public EventTarget getTarget()
```
    Gets event target on which the touch event carrying this touch point is fired.
    
    Returns:
    Event target for this touch point
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of this TouchPoint object.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    a string representation of this TouchPoint object.

Class TouchPoint

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

belongsTo

getGrabbed

grab

grab

ungrab

getId

getState

getX

getY

getScreenX

getScreenY

getSceneX

getSceneY

getTarget

toString