- java.lang.Object
-
- javafx.scene.input.TouchPoint
-
- All Implemented Interfaces:
-
Serializable
public final class TouchPoint extends Object implements Serializable
触摸点表示多点触摸动作的单个点,通常一个手指触摸屏幕。 它包含在TouchEvent
中 。触摸点具有坐标,状态(见
TouchPoint.State
)和ID。 ID是单个多点触摸手势范围内唯一的该触摸点的顺序号。默认情况下,每个触摸点在其整个轨迹中传递到单个节点 - 被按下的节点。 有一个抓住API来修改此行为。 上述表示当按下触摸点时,它被按压坐标上最顶端的节点自动抓取。 任何时候手势
grab()
和ungrab()
方法都可以用来改变事件传递目标。 当被不同的节点抓住时,它将被下一次针对它; 当未解密时,它将始终定位到当前位置上最顶端的节点。- 从以下版本开始:
- JavaFX 2.2
- 另请参见:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 static class
TouchPoint.State
表示触摸点的当前状态
-
构造方法摘要
构造方法 Constructor 描述 TouchPoint(int id, TouchPoint.State state, double x, double y, double screenX, double screenY, EventTarget target, PickResult pickResult)
创建TouchPoint的新实例。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 boolean
belongsTo(EventTarget target)
区分目标在给定节点或其某些孩子的触摸点之间的接触点,指向其他地方。EventTarget
getGrabbed()
获得抓住这个接触点的事件目标。int
getId()
获取此接触点的标识符。PickResult
getPickResult()
返回有关选择的信息。double
getSceneX()
获取触摸点的相对原点的水平位置Scene
包含TouchEvent的来源。double
getSceneY()
获取触摸点的相对原点的垂直位置Scene
包含TouchEvent的来源。double
getScreenX()
获取触摸点的绝对水平位置。double
getScreenY()
获取触摸点的绝对垂直位置。TouchPoint.State
getState()
获取此触点的状态EventTarget
getTarget()
获取触发此触摸点触发事件的事件目标。double
getX()
获取触摸点相对于TouchEvent源的原点的水平位置。double
getY()
获取触摸点相对于TouchEvent源的原点的垂直位置。double
getZ()
事件的相对于MouseEvent源的来源的深度位置。void
grab()
抓住这个接触点的当前事件来源。void
grab(EventTarget target)
按照给定的目标抓住这个接触点。String
toString()
返回此TouchPoint
对象的字符串表示形式。void
ungrab()
从目标中解开这个接触点。
-
-
-
构造方法详细信息
-
TouchPoint
public TouchPoint(int id, TouchPoint.State state, double x, double y, double screenX, double screenY, EventTarget target, PickResult pickResult)
创建TouchPoint的新实例。- 参数
-
id
- 新的接触点的ID -
state
- 新的接触点的状态 -
x
- 相对于场景的x。 -
y
- 相对于现场的y。 -
screenX
- 相对于屏幕的x坐标。 -
screenY
- 相对于屏幕的y坐标。 -
target
- 节点或其他事件目标。 -
pickResult
- 选择结果。 可以为null,在这种情况下,基于场景坐标和目标构建不带任何其他值的2D选取结果 - 从以下版本开始:
- JavaFX 8.0
-
-
方法详细信息
-
belongsTo
public boolean belongsTo(EventTarget target)
区分目标在给定节点或其某些孩子的触摸点之间的接触点,指向其他地方。 这允许测试由一个触摸事件承载的与给定节点的相关性的所有触摸点。- 参数
-
target
- 要测试的节点或其他事件目标 - 结果
- 如果此接触点针对给定目标或其某些子项,则为true
-
getGrabbed
public EventTarget getGrabbed()
获得抓住这个接触点的事件目标。- 结果
- 当前抓住的目标,如果接触点未被解除,则为null
-
grab
public void grab()
抓住这个接触点的当前事件来源。 包含此触点的下一个事件将被定位到事件处理程序称为此方法的同一节点。
-
grab
public void grab(EventTarget target)
按照给定的目标抓住这个接触点。 包含该接触点的下一个事件将被定向到它。- 参数
-
target
- 抓住接触点的目标
-
ungrab
public void ungrab()
从目标中解开这个接触点。 由于下一个事件,这个触摸点将被传送到在其相应位置上选择的最顶端的节点,直到再次被抓住或释放。
-
getId
public final int getId()
获取此接触点的标识符。 该数字在一个多点触摸手势的范围内是连续的和唯一的。 第一个按下的触摸点的编号为1
,每个随后按下的触摸点将获得下一个序号,直到所有触摸点被释放并且计数器被复位。- 结果
- 该接触点的标识符。
-
getState
public final TouchPoint.State getState()
获取此触点的状态- 结果
- 这个接触点的状态
-
getX
public final double getX()
获取触摸点相对于TouchEvent源的原点的水平位置。- 结果
- 触摸点相对于TouchEvent源的原点的水平位置。
-
getY
public final double getY()
获取触摸点相对于TouchEvent源的原点的垂直位置。- 结果
- 触摸点相对于TouchEvent源的原点的垂直位置。
-
getZ
public final double getZ()
事件的相对于MouseEvent源的来源的深度位置。- 结果
- 事件的相对于MouseEvent源的起点的深度位置。
- 从以下版本开始:
- JavaFX 8.0
-
getScreenX
public final double getScreenX()
获取触摸点的绝对水平位置。- 结果
- 触摸点的绝对水平位置
-
getScreenY
public final double getScreenY()
获取触摸点的绝对垂直位置。- 结果
- 触摸点的绝对垂直位置
-
getSceneX
public final double getSceneX()
获取触摸点的相对原点的水平位置Scene
包含TouchEvent的来源。 如果节点不在一个Scene
,那么该值是相对于TouchEvent节点最根的父节点的boundsInParent。 请注意,在3D场景中,这表示应用投影变换后的平面坐标。- 结果
-
触摸点的相对于原点的水平位置
Scene
包含TouchEvent的源
-
getSceneY
public final double getSceneY()
获取触摸点的相对原点的垂直位置Scene
包含TouchEvent的来源。 如果节点不在一个Scene
,那么该值是相对于TouchEvent节点最根的父节点的boundsInParent。 请注意,在3D场景中,这表示应用投影变换后的平面坐标。- 结果
-
触摸点的相对于原点的垂直位置
Scene
包含TouchEvent的源
-
getPickResult
public final PickResult getPickResult()
返回有关选择的信息。- 结果
- 新的PickResult对象包含有关选择的信息
- 从以下版本开始:
- JavaFX 8.0
-
getTarget
public EventTarget getTarget()
获取触发此触摸点触发事件的事件目标。- 结果
- 此接触点的事件目标
-
-