- 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 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
-
-
-
-
构造方法详细信息
-
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
- 结果
- 事件类型
-
-