- 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сisInertia(), возвращающиеtrue, могут появиться послеZOOM_FINISHED.- С тех пор:
- JavaFX 2.2
- См. также:
- Сериализованная форма
-
Краткое описание полей
Поля Модификатор и тип Поле Описание static EventType<ZoomEvent>ANYОбщий супертип для всех типов событий масштабирования.static EventType<ZoomEvent>ZOOMЭто событие возникает, когда пользователь выполняет жест масштабирования, например, раздвигает два пальца.static EventType<ZoomEvent>ZOOM_FINISHEDЭто событие возникает, когда жест масштабирования заканчивается.static 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-источником и -целью.
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание ZoomEventcopyFor(Object newSource, EventTarget newTarget)Создает и возвращает копию данного события с указанным источником и целью события.ZoomEventcopyFor(Object newSource, EventTarget newTarget, EventType<ZoomEvent> type)Создает копию данного события с подставленными полями.EventType<ZoomEvent>getEventType()Возвращает тип события для данного события.doublegetTotalZoomFactor()Возвращает величину масштабирования данного жеста.doublegetZoomFactor()Возвращает величину масштабирования данного события.StringtoString()Возвращает строковое представление данного объекта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
-
-
Подробное описание полей
-
ANY
public static final EventType<ZoomEvent> ANY
Общий супертип для всех типов событий масштабирования.
-
ZOOM
public static final EventType<ZoomEvent> ZOOM
Это событие возникает, когда пользователь выполняет жест масштабирования, например, раздвигает два пальца.
-
-
Подробное описание конструкторов
-
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.- Переопределяет:
-
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- новый тип события - Возвращает:
- Копию события с изменёнными полями
- Since:
- JavaFX 8.0
-
getEventType
public EventType<ZoomEvent> getEventType()
Описание скопировано из класса:EventВозвращает тип события этого события. Объекты одного и того же классаEventмогут иметь разные типы событий. Эти типы событий дополнительно указывают, какое событие произошло.- Переопределяет:
-
getEventTypeв классеGestureEvent - Возвращает:
- Тип события
-
© 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.