Класс 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 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 - 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()

Получает идентификатор этой точки касания. Число является последовательным и уникальным в рамках одного многоточечного жеста. Первая нажатая точка касания имеет id 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.