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

Class MouseDragEvent

  • All Implemented Interfaces:
    Serializable ， Cloneable 

    public final class MouseDragEvent
extends MouseEvent
    鼠标拖动事件在全按下按钮释放手势时被传送到潜在的手势目标。 不同手势类型之间的差异描述于MouseEvent 。

    可以通过调用DRAG_DETECTED事件处理程序内部的一个节点或场景上的startFullDrag()来启动全按下拖动手势。 此呼叫激活在拖动手势期间将MouseDragEvent s传递到光标下的节点。

    当您拖动节点时，它仍然在光标下，因此在整个手势期间它被认为是潜在的手势目标。 如果您需要将节点拖到另一个节点并让另一个节点知道该节点，则需要确保将被拖动节点下的节点作为潜在的手势目标。 您可以通过调用实现这个setMouseTransparent(true)在拖动节点上MOUSE_PRESSED处理程序，并在返回回假MOUSE_RELEASED处理程序。 这样，拖动节点下的节点将接收到MouseDragEvent s，而所有的MouseEvent都将被传送到（当前的鼠标透明）手势源。

    输入/退出的事件与鼠标输入/退出事件的行为类似，请参阅MouseEvent概述。

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

    • 构造方法详细信息

      • MouseDragEvent

        public MouseDragEvent​(Object source,
                      EventTarget target,
                      EventType<MouseDragEvent> eventType,
                      double x,
                      double y,
                      double screenX,
                      double screenY,
                      MouseButton button,
                      int clickCount,
                      boolean shiftDown,
                      boolean controlDown,
                      boolean altDown,
                      boolean metaDown,
                      boolean primaryButtonDown,
                      boolean middleButtonDown,
                      boolean secondaryButtonDown,
                      boolean synthesized,
                      boolean popupTrigger,
                      PickResult pickResult,
                      Object gestureSource)
        构造新的MouseDragEvent事件。
        参数
        source - 事件的来源。 可以为null。
        target - 事件的目标。 可以为null。
        eventType - 事件的类型。
        x - 相对于场景的x。
        y - 相对于场景的y。
        screenX - 相对于屏幕的x坐标。
        screenY - 相对于屏幕的y坐标。
        button - 使用鼠标按钮
        clickCount - 点击次数
        shiftDown - 如果按shift键， shiftDown true。
        controlDown - 如果按下控制修饰符， controlDown true。
        altDown - 如果按住alt修饰符， altDown true。
        metaDown - 如果按下了元修饰符， metaDown true。
        primaryButtonDown - 如果按下主按钮， primaryButtonDown true。
        middleButtonDown - 如果按下中间按钮， middleButtonDown true。
        secondaryButtonDown - 如果按下辅助按钮， secondaryButtonDown true。
        synthesized - 如果这个事件是合成的
        popupTrigger - 此事件是否表示当前平台的弹出式触发器
        pickResult - 选择结果。 可以为null，在这种情况下，基于场景坐标和目标构建不带任何其他值的2D选取结果
        gestureSource - 正在进行的手势的源对象。
        从以下版本开始：
        JavaFX 8.0

      • MouseDragEvent

        public MouseDragEvent​(EventType<MouseDragEvent> eventType,
                      double x,
                      double y,
                      double screenX,
                      double screenY,
                      MouseButton button,
                      int clickCount,
                      boolean shiftDown,
                      boolean controlDown,
                      boolean altDown,
                      boolean metaDown,
                      boolean primaryButtonDown,
                      boolean middleButtonDown,
                      boolean secondaryButtonDown,
                      boolean synthesized,
                      boolean popupTrigger,
                      PickResult pickResult,
                      Object gestureSource)
        构造具有null源和目标的新的MouseDragEvent事件。
        参数
        eventType - 事件的类型。
        x - 相对于场景的x。
        y - 相对于现场的y。
        screenX - 相对于屏幕的x坐标。
        screenY - 相对于屏幕的y坐标。
        button - 使用鼠标按钮
        clickCount - 点击次数
        shiftDown - 如果按shift键， shiftDown true。
        controlDown - 如果按下控制修饰符， controlDown true。
        altDown - 如果按住alt修饰符， altDown true。
        metaDown - 如果按下了元修饰符， metaDown true。
        primaryButtonDown - 如果主按钮被按下， primaryButtonDown true。
        middleButtonDown - 如果按下中间按钮， middleButtonDown true。
        secondaryButtonDown - 如果按下辅助按钮， secondaryButtonDown true。
        synthesized - 如果这个事件是合成的
        popupTrigger - 此事件是否表示当前平台的弹出式触发器
        pickResult - 选择结果。 可以为null，在这种情况下，基于场景坐标构建没有任何进一步值的2D选取结果
        gestureSource - 持续手势的源对象。
        从以下版本开始：
        JavaFX 8.0

    • 方法详细信息

      • getGestureSource

        public Object getGestureSource​()
        返回正在进行的手势的源对象。 手势源是开始完全按下 - 拖动释放手势的对象（正在调用startFullDrag方法）。
        结果
        手势的源对象。

      • toString

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

      • copyFor

        public MouseDragEvent copyFor​(Object newSource,
                              EventTarget newTarget)
        描述从类复制： MouseEvent
        将此事件复制到不同的来源和目标。 在大多数情况下，您不需要使用此方法，它在您触发事件时自动调用。
        重写：
        copyFor在 MouseEvent
        参数
        newSource - 新事件来源
        newTarget - 新事件目标
        结果
        该事件的副本用于不同的来源和目标

      • getEventType

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