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

Класс TouchPoint

  • java.lang.Object
    • javafx.scene.input.TouchPoint
  • Все реализованные интерфейсы:
    Serializable
    public final class TouchPoint
    extends Object
    implements Serializable
    Точка касания представляет собой одну точку в действии многократного касания, обычно один палец, касающийся экрана. Она содержится в TouchEvent.

    Точка касания имеет свои координаты, состояние (см. TouchPoint.State) и ID. ID — это порядковый номер этой точки касания, уникальный в рамках одного жеста многократного касания.

    Каждая точка касания по умолчанию передается одному узлу в течение всего своего пути — узлу, на котором она была нажата. Существует API для захвата, позволяющий изменить это поведение. Вышесказанное означает, что при нажатии точки касания она автоматически захватывается верхним узлом в координатах нажатия. В любое время во время жеста grab() и ungrab() методы могут быть использованы для изменения целевого объекта события. При захвате другим узлом в следующий раз она будет нацелена на него; при отжатии она всегда будет нацелена на верхний узел в текущем местоположении.

    С момента:
    JavaFX 2.2
    См. также:
    Сериализованная форма
  • Краткое описание вложенных классов

    Вложенные классы
    Модификатор и тип Класс Описание
    static class  TouchPoint.State
    Представляет текущее состояние точки касания
  • Краткое описание конструкторов

    Конструкторы
    Конструктор Описание
    TouchPoint​(int id, TouchPoint.State state, double x, double y, double screenX, double screenY, EventTarget target, PickResult pickResult)
    Создает новый экземпляр TouchPoint.
  • Краткое описание методов

    Все методыМетоды экземпляровКонкретные методы
    Модификатор и тип Метод Описание
    boolean belongsTo​(EventTarget target)
    Различает между точками касания, нацеленными на данный узел или некоторых его дочерних элементов, и точками касания, нацеленными где-то еще.
    EventTarget getGrabbed()
    Получает целевой объект события, который захватил эту точку касания.
    int getId()
    Получает идентификатор этой точки касания.
    PickResult getPickResult()
    Возвращает информацию о выборе.
    double getSceneX()
    Получает горизонтальную позицию точки касания относительно начала координат Scene, содержащего источник TouchEvent.
    double getSceneY()
    Получает вертикальную позицию точки касания относительно начала координат Scene, содержащего источник TouchEvent.
    double getScreenX()
    Получает абсолютную горизонтальную позицию точки касания.
    double getScreenY()
    Получает абсолютную вертикальную позицию точки касания.
    TouchPoint.State getState()
    Получает состояние этой точки касания
    EventTarget getTarget()
    Получает целевой объект события, на котором срабатывает событие касания, содержащее эту точку касания.
    double getX()
    Получает горизонтальную позицию точки касания относительно начала координат источника TouchEvent.
    double getY()
    Получает вертикальную позицию точки касания относительно начала координат источника TouchEvent.
    double getZ()
    Глубина позиции события относительно начала координат источника MouseEvent.
    void grab()
    Захватывает эту точку касания текущим источником события.
    void grab​(EventTarget target)
    Захватывает эту точку касания заданным целевым объектом.
    String toString()
    Возвращает строковое представление этого объекта TouchPoint.
    void ungrab()
    Отпускает эту точку касания от её целевого объекта.
    • Методы, унаследованные от класса java.lang.Object

      clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Подробное описание конструкторов

    • TouchPoint

      public TouchPoint​(int id,
                        TouchPoint.State state,
                        double x,
                        double y,
                        double screenX,
                        double screenY,
                        EventTarget target,
                        PickResult pickResult)
      Создаёт новый экземпляр TouchPoint.
      Параметры:
      id - Идентификатор нового касания
      state - Состояние нового касания
      x - Координата X относительно сцены.
      y - Координата Y относительно сцены.
      screenX - Координата X относительно экрана.
      screenY - Координата Y относительно экрана.
      target - Узел или другой целевой объект события.
      pickResult - Результат выбора. Может быть null, в этом случае результат выбора 2D без дополнительных значений создаётся на основе координат сцены и целевого объекта
      С момента:
      JavaFX 8.0
  • Подробное описание методов

    • belongsTo

      public boolean belongsTo​(EventTarget target)
      Определяет, относится ли точка касания к данному узлу или некоторым из его дочерних элементов, или к другому элементу. Это позволяет проверить все точки касания, вызванные одним событием касания, на их релевантность для данного узла.
      Параметры:
      target - Узел или другой целевой объект события для проверки
      Возвращает:
      true, если данная точка касания относится к данному целевому объекту или некоторым из его дочерних элементов
    • getGrabbed

      public EventTarget getGrabbed()
      Возвращает целевой объект события, который захватил данную точку касания.
      Возвращает:
      Текущий захваченный целевой объект, null, если точка касания не захвачена
    • grab

      public void grab()
      Захватывает данную точку касания текущим источником события. Следующее событие, содержащее эту точку касания, будет направлено на тот же узел, обработчик события которого вызвал этот метод.
    • grab

      public void grab​(EventTarget target)
      Захватывает данную точку касания заданным целевым объектом. Следующее событие, содержащее эту точку касания, будет направлено на него.
      Параметры:
      target - Целевой объект, которым следует захватить точку касания
    • ungrab

      public void ungrab()
      Освобождает захват данной точки касания от её целевого объекта. Следующее событие, содержащее эту точку касания, будет передано самому верхнему узлу, выбранному в соответствующем месте, до тех пор, пока оно не будет захвачено снова или не будет отпущено.
    • getId

      public final int getId()
      Возвращает идентификатор этой точки касания. Число является последовательным и уникальным в рамках одного жеста многократного касания. Первая нажатая точка касания имеет идентификатор 1, каждая последующая нажатая точка касания получает следующий порядковый номер, пока все точки касания не будут отпущены, и счётчик не будет сброшен.
      Возвращает:
      идентификатор данной точки касания.
    • getState

      public final TouchPoint.State getState()
      Возвращает состояние данной точки касания
      Возвращает:
      состояние данной точки касания
    • getX

      public final double getX()
      Возвращает горизонтальную позицию точки касания относительно начала координат источника TouchEvent.
      Возвращает:
      горизонтальную позицию точки касания относительно начала координат источника TouchEvent.
    • getY

      public final double getY()
      Возвращает вертикальную позицию точки касания относительно начала координат источника TouchEvent.
      Возвращает:
      вертикальную позицию точки касания относительно начала координат источника TouchEvent.
    • getZ

      public final double getZ()
      Глубина позиции события относительно начала координат источника MouseEvent.
      Возвращает:
      глубину позиции события относительно начала координат источника MouseEvent.
      С момента:
      JavaFX 8.0
    • getScreenX

      public final double getScreenX()
      Возвращает абсолютную горизонтальную позицию точки касания.
      Возвращает:
      абсолютную горизонтальную позицию точки касания
    • getScreenY

      public final double getScreenY()
      Возвращает абсолютную вертикальную позицию точки касания.
      Возвращает:
      абсолютную вертикальную позицию точки касания
    • getSceneX

      public final double getSceneX()
      Возвращает горизонтальную позицию точки касания относительно начала координат Scene, содержащего источник TouchEvent. Если узел не находится в Scene, то значение относится к boundsInParent самого корневого родителя узла TouchEvent. Обратите внимание, что в 3D-сцене это представляет собой плоские координаты после применения проекционных преобразований.
      Возвращает:
      горизонтальную позицию точки касания относительно начала координат Scene, содержащего источник TouchEvent
    • getSceneY

      public final double getSceneY()
      Возвращает вертикальную позицию точки касания относительно начала координат Scene, содержащего источник TouchEvent. Если узел не находится в Scene, то значение относится к boundsInParent самого корневого родителя узла TouchEvent. Обратите внимание, что в 3D-сцене это представляет собой плоские координаты после применения проекционных преобразований.
      Возвращает:
      вертикальную позицию точки касания относительно начала координат Scene, содержащего источник TouchEvent
    • getPickResult

      public final PickResult getPickResult()
      Возвращает информацию о выборе.
      Возвращает:
      новый объект PickResult, содержащий информацию о выборе
      С момента:
      JavaFX 8.0
    • getTarget

      public EventTarget getTarget()
      Возвращает целевой объект события, на котором вызывается событие касания, содержащее эту точку касания.
      Возвращает:
      Целевой объект события для этой точки касания
    • toString

      public String toString()
      Возвращает строковое представление этого объекта TouchPoint.
      Переопределяет:
      toString в классе Object
      Возвращает:
      строковое представление этого объекта TouchPoint.

© 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