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

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

Модификатор и тип	Метод	Описание
`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, если нажата клавиша Ctrl.; 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, если нажата клавиша Ctrl.; 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.