Spec-Zone.ru › OpenJavaFX 21

Класс ZoomEvent

java.lang.Object
java.util.EventObject
javafx.event.Event
javafx.scene.input.InputEvent
javafx.scene.input.GestureEvent
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.

Since:
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 с null-источником и целевым объектом.

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

Модификатор и тип Метод Описание
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, если нажата клавиша Control.
altDown - true, если нажата клавиша Alt.
metaDown - true, если нажата клавиша Meta.
direct - true, если событие вызвано прямым устройством ввода. См. GestureEvent.isDirect()
inertia - указывает, является ли событие инерцией уже завершенного жеста.
zoomFactor - коэффициент масштабирования
totalZoomFactor - накопительный коэффициент масштабирования
pickResult - результат выбора. Может быть null, в этом случае результат выбора 2D без дополнительных значений строится на основе координат сцены и целевого объекта
Since:
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, если нажата клавиша Control.
altDown - true, если нажата клавиша Alt.
metaDown - true, если нажата клавиша Meta.
direct - true, если событие вызвано прямым устройством ввода. См. GestureEvent.isDirect()
inertia - указывает, является ли событие инерцией уже завершенного жеста.
zoomFactor - коэффициент масштабирования
totalZoomFactor - накопительный коэффициент масштабирования
pickResult - результат выбора. Может быть null, в этом случае результат выбора 2D без дополнительных значений строится на основе координат сцены
Since:
JavaFX 8.0

Подробное описание методов

getZoomFactor

public double getZoomFactor()
Возвращает коэффициент масштабирования для этого события. Значение коэффициента удобно использовать при умножении на свойства узла scale (значения больше 1 для увеличения масштаба, значения между 0 и 1 для уменьшения масштаба).
Возвращает:
Коэффициент масштабирования этого события

getTotalZoomFactor

public double getTotalZoomFactor()
Возвращает коэффициент масштабирования для этого жеста. Значение коэффициента удобно использовать при умножении на свойства узла scale (значения больше 1 для увеличения масштаба, значения между 0 и 1 для уменьшения масштаба).
Возвращает:
Накопленный коэффициент масштабирования для этого жеста

toString

public String toString()
Возвращает строковое представление этого объекта ZoomEvent.
Overrides:
toString в классе GestureEvent
Возвращает:
Строковое представление этого объекта ZoomEvent.

copyFor

public ZoomEvent copyFor(Object newSource, EventTarget newTarget)
Описание скопировано из класса: Event
Создаёт и возвращает копию этого события с указанными источником и целевым объектом. Если источник или целевой объект заданы как null, они заменяются значением NULL_SOURCE_TARGET.
Overrides:
copyFor в классе Event
Параметры:
newSource - новый источник скопированного события
newTarget - новый целевой объект скопированного события
Возвращает:
копию события с новым источником и целевым объектом

copyFor

public ZoomEvent copyFor(Object newSource, EventTarget newTarget, EventType<ZoomEvent> type)
Создаёт копию данного события с заменой указанных полей.
Параметры:
newSource - новый источник скопированного события
newTarget - новый целевой объект скопированного события
type - новый тип события
Возвращает:
копию события с заменёнными полями
Since:
JavaFX 8.0

getEventType

public EventType<ZoomEvent> getEventType()
Описание скопировано из класса: Event
Возвращает тип события для этого события. Объекты одного и того же класса Event могут иметь разные типы событий. Эти типы событий дополнительно указывают, какое событие произошло.
Overrides:
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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API