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

Class GestureEvent

  • All Implemented Interfaces:
    Serializable ， Cloneable
    已知直接子类：
    RotateEvent ， ScrollEvent ， SwipeEvent ， ZoomEvent 

    public class GestureEvent
extends InputEvent
    表示手势输入的事件。 手势通常由直接（触摸屏）或间接（轨迹板）触摸事件引起。

    手势的传递取决于底层平台和连接的输入设备的功能。 例如在具有鼠标和键盘的PC上，没有办法产生旋转手势。

    从以下版本开始：
    JavaFX 2.2
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • GestureEvent

        @Deprecated(since="8")
protected GestureEvent​(EventType<? extends GestureEvent> eventType)
        已过时。 不要使用这个构造函数。 构造空事件。
        创建一个新的实例 GestureEvent 。
        参数
        eventType - 事件类型

      • GestureEvent

        @Deprecated(since="8")
protected GestureEvent​(Object source,
                       EventTarget target,
                       EventType<? extends GestureEvent> eventType)
        已过时。 不要使用这个构造函数。 构造空事件。
        创建一个新的 GestureEvent实例。
        参数
        source - 事件源
        target - 事件目标
        eventType - 事件的类型

      • GestureEvent

        protected GestureEvent​(Object source,
                       EventTarget target,
                       EventType<? extends GestureEvent> eventType,
                       double x,
                       double y,
                       double screenX,
                       double screenY,
                       boolean shiftDown,
                       boolean controlDown,
                       boolean altDown,
                       boolean metaDown,
                       boolean direct,
                       boolean inertia,
                       PickResult pickResult)
        构建新的GestureEvent事件。
        参数
        source - 事件的来源。 可以为null。
        target - 事件的目标。 可以为null。
        eventType - 事件的类型。
        x - 相对于场景的x。
        y - 相对于现场的y。
        screenX - 相对于屏幕的x坐标。
        screenY - 相对于屏幕的y坐标。
        shiftDown - 如果按shift键， shiftDown true。
        controlDown - 如果按下控制修饰符， controlDown true。
        altDown - 如果按Alt修饰符， altDown true。
        metaDown - 如果按下了元修饰符， metaDown true。
        direct - 如果事件是由直接输入设备引起的， direct true。 见isDirect()
        inertia - 如果表示已经完成的手势的惯性。
        pickResult - 选择结果。 可以为null，在这种情况下，基于场景坐标和目标构建没有任何进一步值的2D选取结果
        从以下版本开始：
        JavaFX 8.0

      • GestureEvent

        protected GestureEvent​(EventType<? extends GestureEvent> eventType,
                       double x,
                       double y,
                       double screenX,
                       double screenY,
                       boolean shiftDown,
                       boolean controlDown,
                       boolean altDown,
                       boolean metaDown,
                       boolean direct,
                       boolean inertia,
                       PickResult pickResult)
        构造新的GestureEvent事件，具有空源和目标
        参数
        eventType - 事件的类型。
        x - 相对于场景的x。
        y - 相对于现场的y。
        screenX - 相对于屏幕的x坐标。
        screenY - 相对于屏幕的y坐标。
        shiftDown - 如果按shift键， shiftDown true。
        controlDown - 如果按下控制修饰符， controlDown true。
        altDown - 如果按住alt修饰符， altDown true。
        metaDown - 如果按下了元修饰符， metaDown true。
        direct - 如果事件是由直接输入设备引起的， direct true。 见isDirect()
        inertia - 如果表示已经完成的手势的惯性。
        pickResult - 选择结果。 可以为null，在这种情况下，基于场景坐标构建没有任何进一步值的2D选取结果
        从以下版本开始：
        JavaFX 8.0

    • 方法详细信息

      • copyFor

        public GestureEvent copyFor​(Object newSource,
                            EventTarget newTarget)
        使用指定的事件源和目标创建并返回此事件的副本。 如果源或目标设置为null ，它将被NULL_SOURCE_TARGET值替换。
        重写：
        copyFor Event
        参数
        newSource - 复制事件的新来源
        newTarget - 复制事件的新目标
        结果
        事件副本与新的源和目标

      • getX

        public final double getX​()
        获取事件相对于事件源的原点的水平位置。
        结果
        事件相对于事件来源的水平位置。
        另请参见：
        isDirect()

      • getY

        public final double getY​()
        获取事件相对于事件源的原点的垂直位置。
        结果
        事件相对于事件来源的垂直位置。
        另请参见：
        isDirect()

      • getZ

        public final double getZ​()
        事件的相对于MouseEvent源的来源的深度位置。
        结果
        事件的相对于MouseEvent源的起点的深度位置。
        从以下版本开始：
        JavaFX 8.0

      • getScreenX

        public final double getScreenX​()
        获取事件的绝对水平位置。
        结果
        事件的绝对水平位置
        另请参见：
        isDirect()

      • getScreenY

        public final double getScreenY​()
        获取事件的绝对垂直位置。
        结果
        事件的绝对垂直位置
        另请参见：
        isDirect()

      • getSceneX

        public final double getSceneX​()
        获取事件相对于包含事件源的Scene的原点的水平位置。 如果节点不在一个Scene ，则该值相对于该事件节点的根最多父节点的boundsInParent。 请注意，在3D场景中，这表示应用投影变换后的平面坐标。
        结果
        事件相对于包含事件源的 Scene的原点的水平位置
        另请参见：
        isDirect()

      • getSceneY

        public final double getSceneY​()
        获取事件相对于包含事件源的Scene的原点的垂直位置。 如果节点不在一个Scene ，则该值相对于该事件节点的最大父节点的boundsInParent。 请注意，在3D场景中，这表示应用投影变换后的平面坐标。
        结果
        事件的垂直位置相对于包含事件源的 Scene的原点
        另请参见：
        isDirect()

      • isShiftDown

        public final boolean isShiftDown​()
        指示此事件的Shift修饰符是否关闭。
        结果
        如果Shift修饰符关闭此事件，则为true

      • isControlDown

        public final boolean isControlDown​()
        指示此事件的“控制”修饰符是否关闭。
        结果
        如果Control修饰符在此事件中关闭，则为true

      • isAltDown

        public final boolean isAltDown​()
        指示此事件的Alt修饰符是否关闭。
        结果
        如果Alt修饰符关闭此事件，则为true

      • isMetaDown

        public final boolean isMetaDown​()
        表示Meta修饰符在此事件中是否关闭。
        结果
        如果Meta修饰符关闭此事件，则为true

      • isDirect

        public final boolean isDirect​()
        指示此手势是由直接或间接输入设备引起的。 使用直接输入设备，手势直接在具体坐标处执行，典型的例子是触摸屏。 使用间接设备，间接执行手势，通常将鼠标光标位置用作手势坐标，典型的示例是轨迹。
        结果
        如果此事件是由直接输入设备引起的，则为true

      • isInertia

        public boolean isInertia​()
        指示此事件是否表示已经完成的手势的惯性。
        结果
        如果这是惯性事件，则为真

      • getPickResult

        public final PickResult getPickResult​()
        返回有关选择的信息。
        结果
        新的PickResult对象包含有关选择的信息
        从以下版本开始：
        JavaFX 8.0

      • isShortcutDown

        public final boolean isShortcutDown​()
        指示主机平台公共快捷方式修饰符在此事件上是否关闭。 这个常用的快捷键修饰符是修改器键，通常用于主机平台上的快捷方式。 它在Windows上为例如control和Mac上的meta （命令键）。
        结果
        true如果快捷键修饰符关闭，否则为 false

      • toString

        public String toString​()
        返回此 GestureEvent对象的字符串表示形式。
        重写：
        toString在 EventObject
        结果
        这个 GestureEvent对象的字符串表示形式。

      • getEventType

        public EventType<? extends GestureEvent> getEventType​()
        描述从类别复制Event
        获取此事件的事件类型。 同一个Event类的对象可以有不同的事件类型。 这些事件类型进一步指定发生什么样的事件。
        重写：
        getEventType在 InputEvent
        结果
        事件类型