- 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 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- Идентификатор нового касания -
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()
Возвращает целевой объект события, на котором вызывается событие касания, содержащее эту точку касания.- Возвращает:
- Целевой объект события для этой точки касания
-
© 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.