Класс MouseDragEvent

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 EventType<MouseDragEvent>`	`ANY`	Общий супертип для всех типов событий мыши.
`static EventType<MouseDragEvent>`	`MOUSE_DRAG_ENTERED`	Это событие возникает, когда жест входит в узел.
`static EventType<MouseDragEvent>`	`MOUSE_DRAG_ENTERED_TARGET`	Это событие возникает, когда жест входит в узел.
`static EventType<MouseDragEvent>`	`MOUSE_DRAG_EXITED`	Это событие возникает, когда жест выходит из узла.
`static EventType<MouseDragEvent>`	`MOUSE_DRAG_EXITED_TARGET`	Это событие возникает, когда жест выходит из узла.
`static EventType<MouseDragEvent>`	`MOUSE_DRAG_OVER`	Это событие возникает, когда жест прогрессирует внутри этого узла.
`static 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 с нулевым источником и целевым объектом.

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

Модификатор и тип	Метод	Описание
`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, если была нажата кнопка Back; forwardButtonDown - true, если была нажата кнопка Forward; 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.