Класс TouchPoint
- javafx.scene.input.TouchPoint
Все реализуемые интерфейсы:
public final class TouchPoint extends Object implements Serializable
TouchEvent. Точка касания имеет свои координаты, состояние (см. TouchPoint.State) и идентификатор. Идентификатор — это порядковый номер этой точки касания, уникальный в рамках одного многоточечного жеста.
Каждая точка касания по умолчанию доставляется одному узлу на протяжении всего своего траектории — узлу, на котором она была нажата. Существует API захвата для изменения этого поведения. Вышесказанное означает, что когда точка касания нажата, она автоматически захватывается самым верхним узлом в координатах нажатия. В любое время во время жеста grab() и ungrab() методы могут использоваться для изменения целевого объекта доставки события. Когда точка захвачена другим узлом, в следующий раз она будет направлена на него; когда она не захвачена, она всегда будет направлена на самый верхний узел в текущем местоположении.
С:
JavaFX 2.2
См. также:
-
Краткое описание вложенных классов
Вложенные классы Модификатор и тип Класс и описание static classTouchPoint.StateПредставляет текущее состояние точки касания
-
Краткое описание конструкторов
Конструкторы Конструктор и описание TouchPoint(int id, TouchPoint.State state, double x, double y, double screenX, double screenY, EventTarget target, PickResult pickResult)Создает новый экземпляр TouchPoint.
-
Краткое описание методов
Все методыМетоды экземпляровКонкретные методы Модификатор и тип Метод и описание booleanbelongsTo(EventTarget target)Различает точки касания, направленные на данный узел или некоторых из его дочерних элементов, от точек касания, направленных куда-то еще.EventTargetgetGrabbed()Получает целевой объект события, который захватил эту точку касания.intgetId()Получает идентификатор этой точки касания.PickResultgetPickResult()Возвращает информацию о выборе.doublegetSceneX()Получает горизонтальное положение точки касания относительно начала координатScene, содержащего источник TouchEvent.doublegetSceneY()Получает вертикальное положение точки касания относительно начала координатScene, содержащего источник TouchEvent.doublegetScreenX()Получает абсолютное горизонтальное положение точки касания.doublegetScreenY()Получает абсолютное вертикальное положение точки касания.TouchPoint.StategetState()Получает состояние этой точки касанияEventTargetgetTarget()Получает целевой объект события, на котором генерируется событие касания, содержащее эту точку касания.doublegetX()Получает горизонтальное положение точки касания относительно начала координат источника TouchEvent.doublegetY()Получает вертикальное положение точки касания относительно начала координат источника TouchEvent.doublegetZ()Глубина положения события относительно начала координат источника MouseEvent.voidgrab()Захватывает эту точку касания текущим источником события.voidgrab(EventTarget target)Захватывает эту точку касания указанным объектом.StringtoString()Возвращает строковое представление этого объектаTouchPoint.voidungrab()Освобождает захват этой точки касания от ее целевого объекта.
-
Подробное описание конструкторов
-
TouchPoint
public TouchPoint(int id, TouchPoint.State state, double x, double y, double screenX, double screenY, EventTarget target, PickResult pickResult)Создаёт новый экземпляр TouchPoint.Параметры:
id- Идентификатор нового touch pointС:
JavaFX 8.0
-
-
Подробное описание методов
-
belongsTo
public boolean belongsTo(EventTarget target)
Различает touch point, нацеленные на данный узел или некоторых из его дочерних элементов, от touch point, нацеленных на что-то другое. Это позволяет проверить все touch point, переносимые одним touch событием, на их релевантность для данного узла.Параметры:
target- Узел или другая цель события для проверкиВозвращает:
true, если этот touch point нацелен на заданную цель или некоторые из её дочерних элементов
-
getGrabbed
public EventTarget getGrabbed()
Возвращает цель события, которая захватила этот touch point.Возвращает:
Текущая захваченная цель, null, если touch point не захвачен
-
grab
public void grab()
Захватывает этот touch point текущим источником события. Следующее событие, содержащее этот touch point, будет направлено на тот же узел, обработчик события которого вызвал этот метод.
-
grab
public void grab(EventTarget target)
Захватывает этот touch point заданной целью. Следующее событие, содержащее этот touch point, будет направлено на него.Параметры:
target- Цель, которой захватить touch point
-
ungrab
public void ungrab()
Освобождает этот touch point от его цели. Поскольку следующее событие, в котором будет передан этот touch point, будет доставлено в самый верхний узел, выбранный по его положению, пока он не будет захвачен снова или не будет высвобождён.
-
getId
public final int getId()
Возвращает идентификатор этого touch point. Число последовательное и уникальное в рамках одного многоточного жеста. Первый нажатый touch point имеет id1, каждый последующий нажатый touch point получает следующий порядковый номер, пока все touch point не будут отпущены, и счётчик не сбросится.Возвращает:
Идентификатор этого touch point.
-
getState
public final TouchPoint.State getState()
Возвращает состояние этого touch pointВозвращает:
состояние этого touch point
-
getX
public final double getX()
Возвращает горизонтальную позицию touch point относительно начала координат источника TouchEvent.Возвращает:
горизонтальную позицию touch point относительно начала координат источника TouchEvent.
-
getY
public final double getY()
Возвращает вертикальную позицию touch point относительно начала координат источника TouchEvent.Возвращает:
вертикальную позицию touch point относительно начала координат источника TouchEvent.
-
getZ
public final double getZ()
Глубина положения события относительно начала координат источника MouseEvent.Возвращает:
глубина положения события относительно начала координат источника MouseEvent.
С:
JavaFX 8.0
-
getScreenX
public final double getScreenX()
Возвращает абсолютную горизонтальную позицию touch point.Возвращает:
абсолютную горизонтальную позицию touch point
-
getScreenY
public final double getScreenY()
Возвращает абсолютную вертикальную позицию touch point.Возвращает:
абсолютную вертикальную позицию touch point
-
getSceneX
public final double getSceneX()
Возвращает горизонтальную позицию touch point относительно начала координатScene, содержащей источник TouchEvent. Если узел не находится вScene, то значение относительно boundsInParent самого верхнего родителя узла TouchEvent. Обратите внимание, что в 3D сцене это представляет плоские координаты после применения проекционных преобразований.Возвращает:
горизонтальную позицию touch point относительно начала координат
Scene, содержащей источник TouchEvent
-
getSceneY
public final double getSceneY()
Возвращает вертикальную позицию touch point относительно начала координатScene, содержащей источник TouchEvent. Если узел не находится вScene, то значение относительно boundsInParent самого верхнего родителя узла TouchEvent. Обратите внимание, что в 3D сцене это представляет плоские координаты после применения проекционных преобразований.Возвращает:
вертикальную позицию touch point относительно начала координат
Scene, содержащей источник TouchEvent
-
getPickResult
public final PickResult getPickResult()
Возвращает информацию о выборе.Возвращает:
новый объект PickResult, содержащий информацию о выборе
С:
JavaFX 8.0
-
getTarget
public EventTarget getTarget()
Возвращает цель события, на которой было вызвано touch событие, несущее этот touch point.Возвращает:
Цель события для этого touch point
-
toString
public String toString()
Возвращает строковое представление этого объекта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.