The event is delivered to the top-most node picked on the gesture coordinates in time of the gesture start - the whole gesture is delivered to the same node even if the coordinates change during the gesture.
The event provides two values: zoomFactor is the zooming amount
of this event, totalZoomFactor is the zooming amount of the whole
gesture. The values work well when multiplied with the node's scale
properties (values greater than 1 for zooming in).
As all gestures, zooming can be direct (performed directly at the concrete coordinates as on touch screen - the center point among all the touches is usually used as the gesture coordinates) or indirect (performed indirectly as on track pad - the mouse cursor location is usually used as the gesture coordinates).
The gesture's ZOOM events are surrounded by ZOOM_STARTED
and ZOOM_FINISHED events. If zooming inertia is active on the
given platform, some ZOOM events with isInertia() returning
true can come after ZOOM_FINISHED.
| Modifier and Type | Field and Description |
|---|---|
| public static final EventType | ANY
Common supertype for all zoom event types.
|
| private static final long | |
| private final double | |
| public static final EventType | ZOOM
This event occurs when user performs a zooming gesture such as dragging two fingers apart. |
| public static final EventType | ZOOM_FINISHED
This event occurs when a zooming gesture ends. |
| public static final EventType | ZOOM_STARTED
This event occurs when a zooming gesture is detected. |
| private final double |
| Access | Constructor and Description |
|---|---|
| public | ZoomEvent(Object
the source of the event. Can be null. source, EventTarget the target of the event. Can be null. target, final EventType<ZoomEvent> The type of the event. eventType, double The x with respect to the scene. x, double The y with respect to the scene. y, double The x coordinate relative to screen. screenX, double The y coordinate relative to screen. screenY, boolean true if shift modifier was pressed. shiftDown, boolean true if control modifier was pressed. controlDown, boolean true if alt modifier was pressed. altDown, boolean true if meta modifier was pressed. metaDown, boolean true if the event was caused by direct input device. See direct, boolean isDirect()if represents inertia of an already finished gesture. inertia, double zoom amount zoomFactor, double cumulative zoom amount totalZoomFactor, PickResult pick result. Can be null, in this case a 2D pick result
without any further values is constructed
based on the scene coordinates and the target pickResult)Constructs new ZoomEvent event. |
| public | ZoomEvent(final EventType<ZoomEvent>
The type of the event. eventType, double The x with respect to the scene. x, double The y with respect to the scene. y, double The x coordinate relative to screen. screenX, double The y coordinate relative to screen. screenY, boolean true if shift modifier was pressed. shiftDown, boolean true if control modifier was pressed. controlDown, boolean true if alt modifier was pressed. altDown, boolean true if meta modifier was pressed. metaDown, boolean true if the event was caused by direct input device. See direct, boolean isDirect()if represents inertia of an already finished gesture. inertia, double zoom amount zoomFactor, double cumulative zoom amount totalZoomFactor, PickResult pick result. Can be null, in this case a 2D pick result
without any further values is constructed
based on the scene coordinates pickResult)Constructs new ZoomEvent event with null source and target. |
| Modifier and Type | Method and Description |
|---|---|
| public ZoomEvent | copyFor(Object newSource, EventTarget newTarget)
Overrides javafx. Creates and returns a copy of this event with the specified event source and target. |
| public ZoomEvent | Returns: the event copy with the fields substitutedthe new source of the copied event newSource, EventTarget the new target of the copied event newTarget, EventType<ZoomEvent> the new eventType type)Creates a copy of the given event with the given fields substituted. |
| public EventType | getEventType()
Overrides javafx. Gets the event type of this event. |
| public double | Returns: The cumulative zooming amount of this gestureGets the zooming amount of this gesture. |
| public double | |
| public String | Returns: a string representation of thisZoomEvent object.Overrides javafx. Returns a string representation of this |
| ANY | back to summary |
|---|---|
| public static final EventType<ZoomEvent> ANY Hides javafx. Common supertype for all zoom event types. | |
| serialVersionUID | back to summary |
|---|---|
| private static final long serialVersionUID | |
| totalZoomFactor | back to summary |
|---|---|
private final double totalZoomFactor
| |
| ZOOM | back to summary |
|---|---|
| public static final EventType<ZoomEvent> ZOOM This event occurs when user performs a zooming gesture such as dragging two fingers apart. | |
| ZOOM_FINISHED | back to summary |
|---|---|
| public static final EventType<ZoomEvent> ZOOM_FINISHED This event occurs when a zooming gesture ends. | |
| ZOOM_STARTED | back to summary |
|---|---|
| public static final EventType<ZoomEvent> ZOOM_STARTED This event occurs when a zooming gesture is detected. | |
| zoomFactor | back to summary |
|---|---|
private final double zoomFactor
| |
| ZoomEvent | back to summary |
|---|---|
| public ZoomEvent(Object source, EventTarget target, final 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) Constructs new ZoomEvent event.
| |
| ZoomEvent | back to summary |
|---|---|
| public ZoomEvent(final 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) Constructs new ZoomEvent event with null source and target.
| |
| copyFor | back to summary |
|---|---|
| public ZoomEvent copyFor(Object newSource, EventTarget newTarget) Overrides javafx. Doc from javafx. Creates and returns a copy of this event with the specified event source
and target. If the source or target is set to
| |
| copyFor | back to summary |
|---|---|
| public ZoomEvent copyFor(Object newSource, EventTarget newTarget, EventType<ZoomEvent> type) Creates a copy of the given event with the given fields substituted.
| |
| getEventType | back to summary |
|---|---|
| public EventType Overrides javafx. Doc from javafx. Gets the event type of this event. Objects of the same
| |
| getTotalZoomFactor | back to summary |
|---|---|
| public double getTotalZoomFactor() Gets the zooming amount of this gesture. The factor value works well when
multiplied with the node's
| |
| getZoomFactor | back to summary |
|---|---|
| public double getZoomFactor() Gets the zooming amount of this event. The factor value works well when
multiplied with the node's
| |
| toString | back to summary |
|---|---|
| public String toString() Overrides javafx. Returns a string representation of this | |