Module javafx.graphics

软件包 javafx.scene.input

Class ZoomEvent

java.lang.Object

java.util.EventObject

javafx.event.Event

javafx.scene.input.InputEvent

javafx.scene.input.GestureEvent

javafx.scene.input.ZoomEvent

All Implemented Interfaces:

Serializable ， Cloneable

public final class ZoomEvent
extends GestureEvent

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

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

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

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

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

从以下版本开始：

JavaFX 2.2

另请参见：

Serialized Form

Field Summary

Fields

Modifier and Type	Field	描述
static EventType<ZoomEvent>	ANY	所有缩放事件类型的常用超类型。
static EventType<ZoomEvent>	ZOOM	当用户执行缩放手势（例如拖动两根手指）时，会发生此事件。
static EventType<ZoomEvent>	ZOOM_FINISHED	当缩放手势结束时，会发生此事件。
static EventType<ZoomEvent>	ZOOM_STARTED	当检测到缩放手势时，会发生此事件。

Fields inherited from class javafx.event.Event

consumed, eventType, NULL_SOURCE_TARGET, target

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor	描述
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事件。
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事件。

方法摘要

Modifier and Type	方法	描述
ZoomEvent	copyFor(Object newSource, EventTarget newTarget)	使用指定的事件源和目标创建并返回此事件的副本。
ZoomEvent	copyFor(Object newSource, EventTarget newTarget, EventType<ZoomEvent> type)	用给定的字段替换给定事件的副本。
EventType<ZoomEvent>	getEventType()	获取此事件的事件类型。
double	getTotalZoomFactor()	获取此手势的缩放量。
double	getZoomFactor()	获取此事件的缩放量。
String	toString()	返回此 ZoomEvent对象的字符串表示形式。

Methods inherited from class javafx.event.Event

clone, consume, fireEvent, getTarget, isConsumed

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class javafx.scene.input.GestureEvent

getPickResult, getSceneX, getSceneY, getScreenX, getScreenY, getX, getY, getZ, isAltDown, isControlDown, isDirect, isInertia, isMetaDown, isShiftDown, isShortcutDown

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

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的缩放值， 0和1之间的值缩小）相乘时，因子值将很好地工作。

结果

此事件的缩放量

getTotalZoomFactor

public double getTotalZoomFactor()

获取此手势的缩放量。 当与节点的scale属性（大于1的缩放值， 0和1之间的值用于缩小）相乘时，因子值将很好地工作。

结果

此手势的累积缩放量

toString

public String toString()

返回此 ZoomEvent对象的字符串表示形式。

重写：

toString类 GestureEvent

结果

这个 ZoomEvent对象的字符串表示形式。

copyFor

public ZoomEvent copyFor(Object newSource,
                         EventTarget newTarget)

说明从类别复制GestureEvent

使用指定的事件源和目标创建并返回此事件的副本。 如果源或目标设置为null ，它将被替换为NULL_SOURCE_TARGET值。

重写：

copyFor在 GestureEvent

参数

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类的对象可以有不同的事件类型。 这些事件类型进一步指定发生什么样的事件。

重写：

getEventType在 GestureEvent

结果

事件类型