Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.graphics
Пакет javafx.scene.input

Класс TouchEvent

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

    Все методыМетодыКонкретные методы
    Модификатор и тип Метод Описание
    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()
    Возвращает строковое представление этого объекта.
    • Методы, унаследованные от класса 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 в классе 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API