javafx.scene.input

Класс TouchEvent

java.lang.Object

java.util.EventObject
- javafx.event.Event
- - javafx.scene.input.InputEvent
  - - javafx.scene.input.TouchEvent

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

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(EventType<TouchEvent> eventType, TouchPoint touchPoint, List<TouchPoint> touchPoints, int eventSetId, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown)` Создаёт новое событие TouchEvent с null источником и целевым объектом.
`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`	`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.

С момента:

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 - Тип события.

С момента:

JavaFX 8.0

Подробное описание метода
- getTouchCount
```
public int getTouchCount()
```
  Возвращает количество точек касания, представленных этим набором событий касания. Возвращаемое значение соответствует размеру списка touchPoints.
  
  Возвращает:
  
  Количество точек касания, представленных этим набором событий касания.
- copyFor
```
public TouchEvent copyFor(Object newSource,
                          EventTarget newTarget)
```
  Описание скопировано из класса: Event
  
  Создаёт и возвращает копию этого события с указанным источником и целевым объектом события. Если источник или целевой объект установлены в null, они заменяются значением NULL_SOURCE_TARGET.
  
  Переопределяет:
  
  copyFor в классе Event
  
  Параметры:
  
  newSource - новый источник скопированного события
  
  Возвращает:
  
  копию события с новым источником и целевым объектом
- copyFor
```
public TouchEvent copyFor(Object newSource,
                          EventTarget newTarget,
                          EventType<TouchEvent> type)
```
  Создаёт копию заданного события с подставленными значениями указанных полей.
  
  Параметры:
  
  source - новый источник скопированного события
  
  Возвращает:
  
  копию события с подставленными полями
  
  С момента:
  
  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.

Класс TouchEvent

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

Поля, унаследованные от класса javafx.event.Event

Поля, унаследованные от класса java.util.EventObject

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

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

Методы, унаследованные от класса javafx.event.Event

Методы, унаследованные от класса java.util.EventObject

Методы, унаследованные от класса java.lang.Object

Подробное описание поля

ANY

TOUCH_PRESSED

TOUCH_MOVED

TOUCH_RELEASED

TOUCH_STATIONARY

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

TouchEvent

TouchEvent

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

getTouchCount

copyFor

copyFor

getEventType

getEventSetId

isShiftDown

isControlDown

isAltDown

isMetaDown

getTouchPoint

getTouchPoints

toString