Spec-Zone.ru › OpenJavaFX 21

Класс MouseDragEvent

java.lang.Object
java.util.EventObject
javafx.event.Event
javafx.scene.input.InputEvent
javafx.scene.input.MouseEvent
javafx.scene.input.MouseDragEvent
Все реализуемые интерфейсы:
Serializable, Cloneable 
public final class MouseDragEvent extends MouseEvent
События перетаскивания мышью доставляются потенциальным объектам-целям во время полных жестов нажатие-перетаскивание-отпускание. Разница между различными типами жестов описана в MouseEvent.

Полный жест нажатие-перетаскивание-отпускание может быть начат вызовом startFullDrag() (на узле или сцене) внутри обработчика события DRAG_DETECTED. Этот вызов активирует доставку событий MouseDragEvent узлам, которые находятся под курсором во время жеста перетаскивания.

Когда вы перетаскиваете узел, он все еще находится под курсором, поэтому он считается потенциальной целью жеста на протяжении всего жеста. Если вам нужно перетащить узел на другой узел и уведомить другой узел об этом, необходимо убедиться, что узлы под перетаскиваемым узлом выбраны в качестве потенциальных целей жеста. Это можно сделать, вызвав setMouseTransparent(true) на перетаскиваемом узле в обработчике MOUSE_PRESSED и вернув значение false в обработчике MOUSE_RELEASED. Таким образом, узлы под перетаскиваемым узлом получат события MouseDragEvent, а все события MouseEvent все равно будут доставлены источнику жеста (который в данный момент прозрачен для мыши).

События входа/выхода ведут себя аналогично событиям входа/выхода мыши, см. MouseEvent обзор.

С:
JavaFX 2.1
См. также:
  • Сериализованная форма

Краткое описание полей

Модификатор и тип Поле Описание
static final EventType<MouseDragEvent> ANY
Общий супертип для всех типов событий мыши.
static final EventType<MouseDragEvent> MOUSE_DRAG_ENTERED
Это событие возникает, когда жест входит в узел.
static final EventType<MouseDragEvent> MOUSE_DRAG_ENTERED_TARGET
Это событие возникает, когда жест входит в узел.
static final EventType<MouseDragEvent> MOUSE_DRAG_EXITED
Это событие возникает, когда жест выходит из узла.
static final EventType<MouseDragEvent> MOUSE_DRAG_EXITED_TARGET
Это событие возникает, когда жест выходит из узла.
static final EventType<MouseDragEvent> MOUSE_DRAG_OVER
Это событие возникает, когда жест прогрессирует внутри этого узла.
static final EventType<MouseDragEvent> MOUSE_DRAG_RELEASED
Это событие возникает, когда жест заканчивается (отпуская кнопку мыши) на этом узле.

Поля, объявленные в классе javafx.scene.input.MouseEvent

DRAG_DETECTED, MOUSE_CLICKED, MOUSE_DRAGGED, MOUSE_ENTERED, MOUSE_ENTERED_TARGET, MOUSE_EXITED, MOUSE_EXITED_TARGET, MOUSE_MOVED, MOUSE_PRESSED, MOUSE_RELEASED

Поля, объявленные в классе javafx.event.Event

consumed, eventType, NULL_SOURCE_TARGET, target

Поля, объявленные в классе java.util.EventObject

source

Краткое описание конструкторов

Конструктор Описание
MouseDragEvent(Object source, EventTarget target, EventType<MouseDragEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean backButtonDown, boolean forwardButtonDown, boolean synthesized, boolean popupTrigger, PickResult pickResult, Object gestureSource)
Создает новое событие MouseDragEvent.
MouseDragEvent(Object source, EventTarget target, EventType<MouseDragEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean synthesized, boolean popupTrigger, PickResult pickResult, Object gestureSource)
Создает новое событие MouseDragEvent.
MouseDragEvent(EventType<MouseDragEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean synthesized, boolean popupTrigger, PickResult pickResult, Object gestureSource)
Создает новое событие MouseDragEvent с null-источником и -целью.

Краткое описание методов

Модификатор и тип Метод Описание
MouseDragEvent copyFor(Object newSource, EventTarget newTarget)
Копирует это событие для другого источника и другой цели.
MouseDragEvent copyFor(Object newSource, EventTarget newTarget, EventType<? extends MouseEvent> type)
Создает копию данного события со замененными полями.
EventType<MouseDragEvent> getEventType()
Получает тип события этого события.
Object getGestureSource()
Возвращает объект-источник текущего жеста.
String toString()
Возвращает строковое представление этого объекта MouseDragEvent.

Методы, объявленные в классе javafx.scene.input.MouseEvent

copyForMouseDragEvent, getButton, getClickCount, getPickResult, getSceneX, getSceneY, getScreenX, getScreenY, getX, getY, getZ, isAltDown, isBackButtonDown, isControlDown, isDragDetect, isForwardButtonDown, isMetaDown, isMiddleButtonDown, isPopupTrigger, isPrimaryButtonDown, isSecondaryButtonDown, isShiftDown, isShortcutDown, isStillSincePress, isSynthesized, setDragDetect

Методы, объявленные в классе javafx.event.Event

clone, consume, fireEvent, getTarget, isConsumed

Методы, объявленные в классе java.util.EventObject

getSource

Методы, объявленные в классе java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание полей

ANY

public static final EventType<MouseDragEvent> ANY
Общий супертип для всех типов событий мыши.

MOUSE_DRAG_OVER

public static final EventType<MouseDragEvent> MOUSE_DRAG_OVER
Это событие возникает, когда жесты происходят в пределах данного узла.

MOUSE_DRAG_RELEASED

public static final EventType<MouseDragEvent> MOUSE_DRAG_RELEASED
Это событие возникает, когда жест завершается (отпусканием кнопки мыши) на этом узле.

MOUSE_DRAG_ENTERED_TARGET

public static final EventType<MouseDragEvent> MOUSE_DRAG_ENTERED_TARGET
Это событие возникает, когда жест входит в узел. Это «пузырящееся» событие, которое также передаётся всем родительским узлам введённого узла (если оно не было обработано). Когда уведомления о входе мыши в некоторых дочерних узлах не требуются, следует использовать MOUSE_DRAG_ENTERED обработчик событий.
См. также:
  • MouseEvent for more information about mouse entered/exited handling which is similar

MOUSE_DRAG_ENTERED

public static final EventType<MouseDragEvent> MOUSE_DRAG_ENTERED
Это событие возникает, когда жест входит в узел. Этот тип события передаётся только введённому узлу; если родительские узлы хотят отфильтровать его или получить событие, они должны использовать MOUSE_DRAG_ENTERED_TARGET.
См. также:
  • MouseEvent for more information about mouse entered/exited handling which is similar

MOUSE_DRAG_EXITED_TARGET

public static final EventType<MouseDragEvent> MOUSE_DRAG_EXITED_TARGET
Это событие возникает, когда жест выходит из узла. Это «пузырящееся» событие, которое также передаётся всем родительским узлам вышедшего узла (если оно не было обработано). Когда уведомления о выходе мыши из некоторых дочерних узлов не требуются, следует использовать MOUSE_DRAG_EXITED обработчик событий.
См. также:
  • MouseEvent for more information about mouse entered/exited handling which is similar

MOUSE_DRAG_EXITED

public static final EventType<MouseDragEvent> MOUSE_DRAG_EXITED
Это событие возникает, когда жест выходит из узла. Этот тип события передаётся только вышедшему узлу; если родительские узлы хотят отфильтровать его или получить событие, они должны использовать MOUSE_DRAG_EXITED_TARGET.
См. также:
  • MouseEvent for more information about mouse entered/exited handling which is similar

Подробное описание конструкторов

MouseDragEvent

public MouseDragEvent(Object source, EventTarget target, EventType<MouseDragEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean synthesized, boolean popupTrigger, PickResult pickResult, Object gestureSource)
Создаёт новое событие MouseDragEvent. Как MouseEvent.isBackButtonDown(), так и MouseEvent.isForwardButtonDown() вернут false для этого события
Параметры:
source - источник события, который может быть null
target - целевой объект события, который может быть null
eventType - тип события
x - координата x относительно сцены
y - координата y относительно сцены
screenX - координата x относительно экрана
screenY - координата y относительно экрана
button - используемая кнопка мыши
clickCount - количество нажатий
shiftDown - true, если нажата клавиша Shift
controlDown - true, если нажата клавиша Control
altDown - true, если нажата клавиша Alt
metaDown - true, если нажата клавиша Meta
primaryButtonDown - true, если нажата главная кнопка
middleButtonDown - true, если нажата средняя кнопка
secondaryButtonDown - true, если нажата дополнительная кнопка
synthesized - если это синтетическое событие
popupTrigger - указывает, является ли это событие триггером всплывающего окна для текущей платформы
pickResult - результат выбора. Может быть null; в этом случае строится 2D-результат выбора без дополнительных значений на основе координат сцены и целевого объекта
gestureSource - исходный объект текущего жеста
С:
JavaFX 8.0

MouseDragEvent

public MouseDragEvent(Object source, EventTarget target, EventType<MouseDragEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean backButtonDown, boolean forwardButtonDown, boolean synthesized, boolean popupTrigger, PickResult pickResult, Object gestureSource)
Создаёт новое событие MouseDragEvent.
Параметры:
source - источник события, который может быть null
target - целевой объект события, который может быть null
eventType - тип события
x - координата x относительно сцены
y - координата y относительно сцены
screenX - координата x относительно экрана
screenY - координата y относительно экрана
button - используемая кнопка мыши
clickCount - количество нажатий
shiftDown - true, если нажата клавиша Shift
controlDown - true, если нажата клавиша Control
altDown - true, если нажата клавиша Alt
metaDown - true, если нажата клавиша Meta
primaryButtonDown - true, если нажата главная кнопка
middleButtonDown - true, если нажата средняя кнопка
secondaryButtonDown - true, если нажата дополнительная кнопка
backButtonDown - true, если нажата кнопка "назад"
forwardButtonDown - true, если нажата кнопка "вперёд"
synthesized - если это синтетическое событие
popupTrigger - указывает, является ли это событие триггером всплывающего окна для текущей платформы
pickResult - результат выбора. Может быть null; в этом случае строится 2D-результат выбора без дополнительных значений на основе координат сцены и целевого объекта
gestureSource - исходный объект текущего жеста
С:
12

MouseDragEvent

public MouseDragEvent(EventType<MouseDragEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean synthesized, boolean popupTrigger, PickResult pickResult, Object gestureSource)
Создаёт новое событие MouseDragEvent с null-источником и целевым объектом. Как MouseEvent.isBackButtonDown(), так и MouseEvent.isForwardButtonDown() вернут false для этого события.
Параметры:
eventType - тип события
x - координата x относительно сцены
y - координата y относительно сцены
screenX - координата x относительно экрана
screenY - координата y относительно экрана
button - используемая кнопка мыши
clickCount - количество нажатий
shiftDown - true, если нажата клавиша Shift
controlDown - true, если нажата клавиша Control
altDown - true, если нажата клавиша Alt
metaDown - true, если нажата клавиша Meta
primaryButtonDown - true, если нажата главная кнопка
middleButtonDown - true, если нажата средняя кнопка
secondaryButtonDown - true, если нажата дополнительная кнопка
synthesized - если это синтетическое событие
popupTrigger - указывает, является ли это событие триггером всплывающего окна для текущей платформы
pickResult - результат выбора. Может быть null; в этом случае строится 2D-результат выбора на основе координат сцены
gestureSource - исходный объект текущего жеста
С:
JavaFX 8.0

Подробное описание методов

getGestureSource

public Object getGestureSource()
Возвращает объект-источник текущего жеста. Источник жеста — это объект, который инициировал весь жест «нажатие-перетаскивание-отпускание» (вызвав метод startFullDrag на нём).
Возвращает:
Объект-источник жеста.

toString

public String toString()
Возвращает строковое представление этого MouseDragEvent объекта.
Переопределяет:
toString в классе MouseEvent
Возвращает:
Строковое представление этого MouseDragEvent объекта.

copyFor

public MouseDragEvent copyFor(Object newSource, EventTarget newTarget)
Описание скопировано из класса: MouseEvent
Копирует это событие для другого источника и целевого объекта. В большинстве случаев вам не нужно использовать этот метод; он вызывается автоматически при запуске события.
Переопределяет:
copyFor в классе MouseEvent
Параметры:
newSource - Новый источник события
newTarget - Новый целевой объект события
Возвращает:
Копию этого события для другого источника и целевого объекта

copyFor

public MouseDragEvent copyFor(Object newSource, EventTarget newTarget, EventType<? extends MouseEvent> type)
Описание скопировано из класса: MouseEvent
Создаёт копию данного события с заменой заданных полей.
Overrides:
copyFor в классе MouseEvent
Параметры:
newSource — новый источник скопированного события
newTarget — новая цель скопированного события
type — новый тип события
Возвращает:
копию события с замещёнными полями

getEventType

public EventType<MouseDragEvent> getEventType()
Описание скопировано из класса: Event
Получает тип события этого события. Объекты одного и того же класса Event могут иметь разные типы событий. Эти типы событий дополнительно указывают, какой вид события произошёл.
Overrides:
getEventType в классе Event
Возвращает:
тип события

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API