Module  javafx.graphics
软件包  javafx.scene.input

Class 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
      表示触摸点的当前状态
    • 方法摘要

      所有方法  接口方法  具体的方法 
      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​()
        获取触发此触摸点触发事件的事件目标。
        结果
        此接触点的事件目标
      • toString

        public String toString​()
        返回此 TouchPoint对象的字符串表示形式。
        重写:
        toStringObject
        结果
        这个 TouchPoint对象的字符串表示形式。