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

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