Класс TouchEvent

javafx.scene.input.TouchEvent

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

public final class TouchEvent
extends InputEvent

Событие касания указывает на действие на сенсорном экране. Оно содержит подробную информацию о каждой точке касания.

Точка касания представляет собой отдельный палец, который был нажат, и имеет свои координаты, состояние (нажато/перемещено/отпущено/неподвижно) и уникальный идентификатор в рамках одного жеста. Для подробных сведений см. TouchPoint.

Для каждого действия с несколькими касаниями генерируется набор событий касания — по одной точке касания. Событие имеет тип, соответствующий состоянию его точки касания. Каждое из событий также содержит список всех точек касания. Эта конструкция позволяет обрабатывать сложные действия с несколькими касаниями из одного места, сохраняя при этом возможность фильтровать/обрабатывать каждую точку касания отдельно. Для распознавания событий, принадлежащих одному набору, используется метод getEventSetId().

Каждая точка касания, аналогично перетаскиванию мышью, доставляется на единственный узел, на котором она была нажата, независимо от того, куда затем она перемещается. Это поведение можно изменить, используя механизм захвата, описанный в документации TouchPoint.

C момента:: JavaFX 2.2
См. также:: Сериализованная форма

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

Поля
Модификатор и тип	Поле	Описание
`static EventType<TouchEvent>`	`ANY`	Общий супертип для всех типов событий касания.
`static EventType<TouchEvent>`	`TOUCH_MOVED`	Это событие возникает при перемещении точки касания.
`static EventType<TouchEvent>`	`TOUCH_PRESSED`	Это событие возникает при нажатии точки касания (первое касание).
`static EventType<TouchEvent>`	`TOUCH_RELEASED`	Это событие возникает при отпускании точки касания.
`static EventType<TouchEvent>`	`TOUCH_STATIONARY`	Это событие возникает при нажатии и удержании точки касания (без перемещения).

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

consumed, eventType, NULL_SOURCE_TARGET, target

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

source

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

Конструкторы
Конструктор	Описание
`TouchEvent(Object source, EventTarget target, EventType<TouchEvent> eventType, TouchPoint touchPoint, List<TouchPoint> touchPoints, int eventSetId, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown)`	Создает новое событие TouchEvent.
`TouchEvent(EventType<TouchEvent> eventType, TouchPoint touchPoint, List<TouchPoint> touchPoints, int eventSetId, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown)`	Создает новое событие TouchEvent с null source и target.

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

Модификатор и тип	Метод	Описание
`TouchEvent`	`copyFor(Object newSource, EventTarget newTarget)`	Создает и возвращает копию этого события с указанным источником и целевым объектом события.
`TouchEvent`	`copyFor(Object newSource, EventTarget newTarget, EventType<TouchEvent> type)`	Создает копию данного события с заданными подставленными полями.
`int`	`getEventSetId()`	Получает порядковый номер набора событий касания, представляющих одно и то же действие с несколькими касаниями.
`EventType<TouchEvent>`	`getEventType()`	Получает тип события этого события.
`int`	`getTouchCount()`	Возвращает количество точек касания, представленных этим набором событий касания.
`TouchPoint`	`getTouchPoint()`	Получает точку касания этого события.
`List<TouchPoint>`	`getTouchPoints()`	Получает все точки касания, представленные этим набором событий касания, включая точку касания этого события.
`boolean`	`isAltDown()`	Указывает, нажата ли модификаторная клавиша Alt в этом событии.
`boolean`	`isControlDown()`	Указывает, нажата ли модификаторная клавиша Control в этом событии.
`boolean`	`isMetaDown()`	Указывает, нажата ли модификаторная клавиша Meta в этом событии.
`boolean`	`isShiftDown()`	Указывает, нажата ли модификаторная клавиша Shift в этом событии.
`String`	`toString()`	Возвращает строковое представление этого объекта `TouchEvent`.

Методы, объявленные в классе 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<TouchEvent> ANY

Общий супертип для всех типов событий касания.

TOUCH_PRESSED

public static final EventType<TouchEvent> TOUCH_PRESSED

Это событие происходит при нажатии точки касания (первое касание).

TOUCH_MOVED

public static final EventType<TouchEvent> TOUCH_MOVED

Это событие происходит при перемещении точки касания.

TOUCH_RELEASED

public static final EventType<TouchEvent> TOUCH_RELEASED

Это событие происходит при отпускании точки касания.

TOUCH_STATIONARY

public static final EventType<TouchEvent> TOUCH_STATIONARY

Это событие происходит, когда точка касания нажата и неподвижна (не перемещается).

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

TouchEvent

public TouchEvent(Object source, EventTarget target, EventType<TouchEvent> eventType, TouchPoint touchPoint, List<TouchPoint> touchPoints, int eventSetId, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown)

Создаёт новое событие TouchEvent.

Параметры:: source - источник события. Может быть null.; target - целевой объект события. Может быть null.; eventType - Тип события.; touchPoint - точка касания для этого события; touchPoints - набор точек касания для действия с несколькими касаниями; eventSetId - идентификатор набора действия с несколькими касаниями; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Control.; altDown - true, если нажата клавиша Alt.; metaDown - true, если нажата клавиша Meta.
С момента:: JavaFX 8.0

TouchEvent

public TouchEvent(EventType<TouchEvent> eventType, TouchPoint touchPoint, List<TouchPoint> touchPoints, int eventSetId, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown)

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

Параметры:: eventType - Тип события.; touchPoint - точка касания для этого события; touchPoints - набор точек касания для действия с несколькими касаниями; eventSetId - идентификатор набора действия с несколькими касаниями; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Control.; altDown - true, если нажата клавиша Alt.; metaDown - true, если нажата клавиша Meta.
С момента:: JavaFX 8.0

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

getTouchCount

public int getTouchCount()

Возвращает количество точек касания, представленных этим набором событий касания. Возвращаемое число соответствует размеру списка touchPoints.

Возвращает:: Количество точек касания, представленных этим набором событий касания.

copyFor

public TouchEvent copyFor(Object newSource, EventTarget newTarget)

Создаёт и возвращает копию этого события с указанным источником и целевым объектом. Если источник или целевой объект установлен в значение null, он заменяется значением NULL_SOURCE_TARGET.

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

copyFor

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

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

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

getEventType

public EventType<TouchEvent> getEventType()

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

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

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

getEventSetId

public final int getEventSetId()

Получает порядковый номер набора событий касания, представляющих одно и то же действие с несколькими касаниями. При многоточечном взаимодействии пользователя может существовать несколько точек касания; каждая из них производит событие касания, каждое из этих событий касания содержит один и тот же список точек касания — и все они возвращают одно и то же число из этого метода. Затем состояние некоторых точек касания изменяется, и новый набор событий имеет новый идентификатор. Идентификатор гарантированно является последовательным и уникальным в пределах одного жеста (сбрасывается, когда все точки касания отпущены).

Возвращает:: Последовательный идентификатор набора событий, уникальный в рамках одного жеста

isShiftDown

public final boolean isShiftDown()

Возвращает значение, указывающее, нажата ли клавиша Shift в этом событии.

Возвращает:: true, если клавиша Shift нажата в этом событии

isControlDown

public final boolean isControlDown()

Возвращает значение, указывающее, нажата ли клавиша Control в этом событии.

Возвращает:: true, если клавиша Control нажата в этом событии

isAltDown

public final boolean isAltDown()

Возвращает значение, указывающее, нажата ли клавиша Alt в этом событии.

Возвращает:: true, если клавиша Alt нажата в этом событии

isMetaDown

public final boolean isMetaDown()

Возвращает значение, указывающее, нажата ли клавиша Meta в этом событии.

Возвращает:: true, если клавиша Meta нажата в этом событии

getTouchPoint

public TouchPoint getTouchPoint()

Получает точку касания этого события.

Возвращает:: Точка касания этого события

getTouchPoints

public List<TouchPoint> getTouchPoints()

Получает все точки касания, представленные этим набором событий касания, включая точку касания этого события. Список является неизменяемым и отсортирован по их идентификаторам, что также означает, что он отсортирован по времени их нажатия. Для различения точек касания, относящихся к узлу, и несвязанных точек касания, можно использовать метод belongsTo TouchPoint.

Возвращает:: Все текущие точки касания в неизменяемом списке

toString

public String toString()

Возвращает строковое представление этого объекта TouchEvent.

Переопределяет:: toString в классе EventObject
Возвращает:: строковое представление этого объекта TouchEvent.

© 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.