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

Class ZoomEvent

  • All Implemented Interfaces:
    SerializableCloneable


    public final class ZoomEvent
    extends GestureEvent
    缩放事件表示用户执行缩放手势,例如在轨迹板,触摸屏或其他类似设备上分开拖动两根手指。

    该事件被传送到在手势开始时在手势坐标上选择的最顶端的节点 - 即使坐标在手势期间改变,也将整个手势传送到同一节点。

    该事件提供两个值: zoomFactor是该事件的缩放量, totalZoomFactor是整个手势的缩放量。 当与节点的scale属性(值大于1进行放大)相乘时,值将很好地工作。

    作为所有手势,缩放可以是直接的(直接在具体坐标处直接执行在触摸屏上 - 所有触摸中的中心点通常用作手势坐标)或间接(间接执行在跟踪板上 - 鼠标光标位置是通常用作手势坐标)。

    手势的ZOOM事件被ZOOM_STARTEDZOOM_FINISHED事件ZOOM_FINISHED 如果在缩放惯性是活跃在给定的平台上,一些ZOOM事件与isInertia()返回true可以来后ZOOM_FINISHED

    从以下版本开始:
    JavaFX 2.2
    另请参见:
    Serialized Form
    • 字段详细信息

      • ANY

        public static final EventType<ZoomEvent> ANY
        所有缩放事件类型的常用超类型。
      • ZOOM

        public static final EventType<ZoomEvent> ZOOM
        当用户执行缩放手势(例如拖动两根手指)时,会发生此事件。
      • ZOOM_STARTED

        public static final EventType<ZoomEvent> ZOOM_STARTED
        当检测到缩放手势时,会发生此事件。
      • ZOOM_FINISHED

        public static final EventType<ZoomEvent> ZOOM_FINISHED
        当缩放手势结束时,会发生此事件。
    • 构造方法详细信息

      • ZoomEvent

        public ZoomEvent​(Object source,
                         EventTarget target,
                         EventType<ZoomEvent> eventType,
                         double x,
                         double y,
                         double screenX,
                         double screenY,
                         boolean shiftDown,
                         boolean controlDown,
                         boolean altDown,
                         boolean metaDown,
                         boolean direct,
                         boolean inertia,
                         double zoomFactor,
                         double totalZoomFactor,
                         PickResult pickResult)
        构造新的ZoomEvent事件。
        参数
        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。 参见GestureEvent.isDirect()
        inertia - 如果表示已经完成的手势的惯性。
        zoomFactor - 缩放量
        totalZoomFactor - 累积缩放量
        pickResult - 选择结果。 可以为null,在这种情况下,基于场景坐标和目标构建没有任何进一步值的2D选取结果
        从以下版本开始:
        JavaFX 8.0
      • ZoomEvent

        public ZoomEvent​(EventType<ZoomEvent> eventType,
                         double x,
                         double y,
                         double screenX,
                         double screenY,
                         boolean shiftDown,
                         boolean controlDown,
                         boolean altDown,
                         boolean metaDown,
                         boolean direct,
                         boolean inertia,
                         double zoomFactor,
                         double totalZoomFactor,
                         PickResult pickResult)
        构造具有null源和目标的新的ZoomEvent事件。
        参数
        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。 GestureEvent.isDirect()
        inertia - 如果表示已经完成的手势的惯性。
        zoomFactor - 缩放量
        totalZoomFactor - 累积缩放量
        pickResult - 选择结果。 可以为null,在这种情况下,基于场景坐标构建没有任何进一步值的2D选取结果
        从以下版本开始:
        JavaFX 8.0
    • 方法详细信息

      • getZoomFactor

        public double getZoomFactor​()
        获取此事件的缩放量。 当与节点的scale属性(大于1的缩放值, 01之间的值缩小)相乘时,因子值将很好地工作。
        结果
        此事件的缩放量
      • getTotalZoomFactor

        public double getTotalZoomFactor​()
        获取此手势的缩放量。 当与节点的scale属性(大于1的缩放值, 01之间的值用于缩小)相乘时,因子值将很好地工作。
        结果
        此手势的累积缩放量
      • toString

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

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

        public ZoomEvent copyFor​(Object newSource,
                                 EventTarget newTarget,
                                 EventType<ZoomEvent> type)
        用给定的字段替换给定事件的副本。
        参数
        newSource - 复制事件的新来源
        newTarget - 复制事件的新目标
        type - 新的eventType
        结果
        事件副本与字段被替换
        从以下版本开始:
        JavaFX 8.0
      • getEventType

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