Класс ZoomEvent

javafx.scene.input.ZoomEvent

Все реализованные интерфейсы:: Serializable, Cloneable

public final class ZoomEvent extends GestureEvent

Событие масштабирования указывает, что пользователь выполнил жест масштабирования, например, раздвинул два пальца на трекпаде, сенсорном экране или другом аналогичном устройстве.

Событие доставляется самому верхнему узлу, выбранному по координатам жеста в момент начала жеста — весь жест доставляется одному и тому же узлу, даже если координаты меняются во время жеста.

Событие предоставляет два значения: zoomFactor — величина масштабирования данного события, totalZoomFactor — величина масштабирования всего жеста. Значения хорошо работают, когда их умножают на свойства scale узла (значения больше, чем 1 для приближения).

Как и все жесты, масштабирование может быть прямым (выполняется непосредственно по конкретным координатам, как на сенсорном экране — обычно используется центральная точка между всеми касаниями в качестве координат жеста) или косвенным (выполняется косвенно, как на трекпаде — обычно используется расположение курсора мыши в качестве координат жеста).

События ZOOM жеста окружены событиями ZOOM_STARTED и ZOOM_FINISHED. Если на данной платформе включена инерция масштабирования, после события ZOOM_FINISHED могут появиться некоторые события ZOOM с isInertia(), возвращающие true.

С:

JavaFX 2.2

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final EventType<ZoomEvent>`	`ANY`	Общий супертип для всех типов событий масштабирования.
`static final EventType<ZoomEvent>`	`ZOOM`	Это событие возникает, когда пользователь выполняет жест масштабирования, например, раздвигает два пальца.
`static final EventType<ZoomEvent>`	`ZOOM_FINISHED`	Это событие возникает, когда заканчивается жест масштабирования.
`static final EventType<ZoomEvent>`	`ZOOM_STARTED`	Это событие возникает, когда обнаруживается жест масштабирования.

Поля, объявленные в классе javafx.event.Event

consumed, eventType, NULL_SOURCE_TARGET, target

Поля, объявленные в классе java.util.EventObject

source

Краткое описание конструкторов

Конструктор	Описание
`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)`	Создает новое событие ZoomEvent с нулевым источником и целевым объектом.

Краткое описание методов

Модификатор и тип	Метод	Описание
`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`.

Методы, объявленные в классе javafx.scene.input.GestureEvent

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

Методы, объявленные в классе javafx.event.Event

clone, consume, fireEvent, getTarget, isConsumed

Методы, объявленные в классе java.util.EventObject

getSource

Методы, объявленные в классе 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 - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Ctrl.; altDown - true, если нажата клавиша Alt.; metaDown - true, если нажата клавиша Meta.; direct - true, если событие вызвано непосредственным устройством ввода. См. GestureEvent.isDirect(); inertia - true, если событие представляет инерцию уже завершенного жеста.; 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)

Создает новое событие ZoomEvent с null источником и целевым объектом.

Параметры:: eventType - Тип события.; x - Координата x относительно сцены.; y - Координата y относительно сцены.; screenX - Координата x относительно экрана.; screenY - Координата y относительно экрана.; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Ctrl.; altDown - true, если нажата клавиша Alt.; metaDown - true, если нажата клавиша Meta.; direct - true, если событие вызвано непосредственным устройством ввода. См. GestureEvent.isDirect(); inertia - true, если событие представляет инерцию уже завершенного жеста.; 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 в классе Event
Параметры:: newSource - новый источник скопированного события; newTarget - новый целевой объект скопированного события
Возвращает:: Копию события с новым источником и целевым объектом

copyFor

public ZoomEvent copyFor(Object newSource, EventTarget newTarget, EventType<ZoomEvent> type)

Создает копию данного события с подставленными полями.

Параметры:: newSource - новый источник скопированного события; newTarget - новый целевой объект скопированного события; type - новый тип события
Возвращает:: Копию события с подставленными полями
С тех пор:: JavaFX 8.0

getEventType

public EventType<ZoomEvent> getEventType()

Описание скопировано из класса: Event

Получает тип события этого события. Объекты одного и того же класса Event могут иметь разные типы событий. Эти типы событий дополнительно указывают, какое событие произошло.

Переопределяет:: getEventType в классе Event
Возвращает:: Тип события

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.