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

См. также:

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. Оба 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, если нажата клавиша Ctrl; 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, если нажата клавиша Ctrl; 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, если нажата клавиша Ctrl; 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

Копирует это событие для другого источника и целевой точки. В большинстве случаев вам не нужно использовать этот метод, он вызывается автоматически при срабатывании события.

Overrides:: 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.