- 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 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 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 с нулевым источником и целевым объектом.
-
Краткое описание методов
Все методыМетоды классаКонкретные методы Модификатор и тип Метод Описание MouseDragEventcopyFor(Object newSource, EventTarget newTarget)Копирует это событие для другого источника и целевого объекта.MouseDragEventcopyFor(Object newSource, EventTarget newTarget, EventType<? extends MouseEvent> type)Создает копию данного события с подставленными значениями полей.EventType<MouseDragEvent>getEventType()Получает тип события данного события.ObjectgetGestureSource()Возвращает объект источника текущего жеста.StringtoString()Возвращает строковое представление этого объектаMouseDragEvent.-
Методы, унаследованные от класса javafx.scene.input.MouseEvent
copyForMouseDragEvent, getButton, getClickCount, getPickResult, getSceneX, getSceneY, getScreenX, getScreenY, getX, getY, getZ, isAltDown, isControlDown, isDragDetect, isMetaDown, isMiddleButtonDown, isPopupTrigger, isPrimaryButtonDown, isSecondaryButtonDown, isShiftDown, isShortcutDown, isStillSincePress, isSynthesized, setDragDetect
-
Методы, унаследованные от класса javafx.event.Event
clone, consume, fireEvent, getTarget, isConsumed
-
Методы, унаследованные от класса java.util.EventObject
getSource
-
-
Подробное описание полей
-
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обработчик событий должен быть использован.
-
MOUSE_DRAG_ENTERED
public static final EventType<MouseDragEvent> MOUSE_DRAG_ENTERED
Это событие происходит, когда жест входит в узел. Этот тип события доставляется только введённому узлу, если родительские элементы хотят отфильтровать его или получить событие подъёма, они должны использоватьMOUSE_DRAG_ENTERED_TARGET.
-
MOUSE_DRAG_EXITED_TARGET
public static final EventType<MouseDragEvent> MOUSE_DRAG_EXITED_TARGET
Это событие происходит, когда жест выходит из узла. Это вариант «подъёма», который также доставляется всем родительским элементам выходящего узла (если он не был обработан). Когда уведомления о выходе мыши из некоторых из дочерних узлов нежелательны,MOUSE_DRAG_EXITEDобработчик событий должен быть использован.
-
MOUSE_DRAG_EXITED
public static final EventType<MouseDragEvent> MOUSE_DRAG_EXITED
Это событие происходит, когда жест выходит из узла. Этот тип события доставляется только выходящему узлу, если родительские элементы хотят отфильтровать его или получить событие подъёма, они должны использоватьMOUSE_DRAG_EXITED_TARGET.
-
-
Подробное описание конструкторов
-
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.- Параметры:
-
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(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-источником и целью.- Параметры:
-
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Создаёт копию заданного события с заменой указанных полей.- Переопределяет:
-
copyForв классеMouseEvent - Параметры:
-
newSource- новый источник скопированного события -
newTarget- новая цель скопированного события -
type- новый тип события - Возвращает:
- Копию события с заменёнными полями
-
getEventType
public EventType<MouseDragEvent> getEventType()
Описание скопировано из класса:EventПолучает тип события этого события. Объекты одного и того жеEventкласса могут иметь разные типы событий. Эти типы событий далее уточняют, какое событие произошло.- Переопределяет:
-
getEventTypeв классеMouseEvent - Возвращает:
- тип события
-
© 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.