Класс TouchPoint

java.lang.Object

javafx.scene.input.TouchPoint

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

public final class TouchPoint extends Object implements Serializable

Точка касания представляет собой отдельную точку многосенсорного действия, как правило, один палец, касающийся экрана. Она содержится в TouchEvent.

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

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

С:

JavaFX 2.2

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static enum`	`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()`	Получает целевой объект события, который захватил эту точку касания.
`final int`	`getId()`	Получает идентификатор этой точки касания.
`final PickResult`	`getPickResult()`	Возвращает информацию о выборе.
`final double`	`getSceneX()`	Получает горизонтальную позицию точки касания относительно начала координат `Scene`, содержащего источник TouchEvent.
`final double`	`getSceneY()`	Получает вертикальную позицию точки касания относительно начала координат `Scene`, содержащего источник TouchEvent.
`final double`	`getScreenX()`	Получает абсолютную горизонтальную позицию точки касания.
`final double`	`getScreenY()`	Получает абсолютную вертикальную позицию точки касания.
`final TouchPoint.State`	`getState()`	Получает состояние этой точки касания
`EventTarget`	`getTarget()`	Получает целевой объект события, на котором генерируется событие касания, содержащее эту точку касания.
`final double`	`getX()`	Получает горизонтальную позицию точки касания относительно начала координат источника TouchEvent.
`final double`	`getY()`	Получает вертикальную позицию точки касания относительно начала координат источника TouchEvent.
`final 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.