- java.lang.Object
-
- java.util.EventObject
-
- javafx.event.Event
-
- javafx.scene.input.InputEvent
-
- javafx.scene.input.TouchEvent
-
- Все реализованные интерфейсы:
-
Serializable,Cloneable
public final class TouchEvent extends InputEvent
Событие касания указывает на действие на сенсорном экране. Оно содержит подробную информацию о каждой точке касания.Точка касания представляет собой отдельный палец, коснувшийся экрана, и имеет своё положение, состояние (нажата/перемещена/отпущена/неподвижна) и уникальный идентификатор в рамках одного жеста. Подробное описание см. в
TouchPoint.Для каждого действия с несколькими касаниями генерируется набор событий касания - по одной точке касания. Событие имеет тип, соответствующий состоянию его точки касания. Каждое из событий также содержит список всех точек касания. Эта конструкция позволяет обрабатывать сложные действия с несколькими касаниями из одного места, сохраняя при этом возможность фильтрации/потребления каждой точки касания по отдельности. Для определения, какие события относятся к одному набору, используется метод
getEventSetId().Каждая точка касания, подобно перетаскиванию мышью, передаётся одному узлу, на котором она была нажата, независимо от того, куда она перемещается. Этот поведение можно изменить, используя механизм захвата, описанный в документации
TouchPoint.- С момента:
- 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 источником и целевым объектом.
-
Краткое описание методов
Все методыМетодыКонкретные методы Модификатор и тип Метод Описание TouchEventcopyFor(Object newSource, EventTarget newTarget)Создаёт и возвращает копию этого события с указанным источником и целевым объектом.TouchEventcopyFor(Object newSource, EventTarget newTarget, EventType<TouchEvent> type)Создаёт копию данного события с подставленными значениями заданных полей.intgetEventSetId()Получает порядковый номер набора событий касания, представляющих одно и то же действие с несколькими касаниями.EventType<TouchEvent>getEventType()Возвращает тип события этого события.intgetTouchCount()Возвращает количество точек касания, представленных этим событием.TouchPointgetTouchPoint()Получает точку касания этого события.List<TouchPoint>getTouchPoints()Получает все точки касания, представленные этим набором событий касания, включая точку касания этого события.booleanisAltDown()Указывает, нажата ли клавиша Alt в этом событии.booleanisControlDown()Указывает, нажата ли клавиша Control в этом событии.booleanisMetaDown()Указывает, нажата ли клавиша Meta в этом событии.booleanisShiftDown()Указывает, нажата ли клавиша Shift в этом событии.StringtoString()Возвращает строковое представление этого объекта.-
Методы, унаследованные от класса javafx.event.Event
clone, consume, fireEvent, getTarget, isConsumed
-
Методы, унаследованные от класса java.util.EventObject
getSource
-
-
Подробное описание полей
-
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
public TouchEvent copyFor(Object newSource, EventTarget newTarget, EventType<TouchEvent> type)
Создает копию данного события с подстановкой указанных полей.- Параметры:
-
newSource- новый источник скопированного события -
newTarget- новый целевой объект скопированного события -
type- новый тип события - Возвращает:
- копию события с подставленными полями
- С момента:
- JavaFX 8.0
-
getEventType
public EventType<TouchEvent> getEventType()
Описание скопировано из класса:EventПолучает тип события этого события. Объекты одного и того же классаEventмогут иметь разные типы событий. Эти типы событий дополнительно указывают, какой вид события произошел.- Переопределяет:
-
getEventTypeв классеInputEvent - Возвращает:
- тип события
-
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.