Класс TouchEvent

javafx.scene.input.TouchEvent

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

public final class TouchEvent extends InputEvent

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

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

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

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

С тех пор как:

JavaFX 2.2

См. также:

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

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

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

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

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

getTouchCount

public int getTouchCount()

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

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

copyFor

public TouchEvent copyFor(Object newSource, EventTarget newTarget)

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

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

copyFor

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

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

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

getEventType

public EventType<TouchEvent> getEventType()

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

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

Overrides:: 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.

Overrides:: 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.