javafx.scene.input

Класс MouseDragEvent

java.lang.Object

java.util.EventObject
- javafx.event.Event
- - javafx.scene.input.InputEvent
  - - javafx.scene.input.MouseEvent
    - - javafx.scene.input.MouseDragEvent

Все реализованные интерфейсы:

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(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(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`	`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, isControlDown, isDragDetect, 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.

Параметры:

source - источник события. Может быть null.

С:

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 - Тип события.

С:

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 - Новый источник события
  
  Возвращает:
  
  копию этого события для другого источника и цели
- copyFor
```
public MouseDragEvent copyFor(Object newSource,
                              EventTarget newTarget,
                              EventType<? extends MouseEvent> type)
```
  Описание скопировано из класса: MouseEvent
  
  Создаёт копию данного события с заменой указанных полей.
  
  Переопределяет:
  
  copyFor в классе MouseEvent
  
  Возвращает:
  
  копию события с заменёнными полями
- 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.

Класс MouseDragEvent

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

Поля, унаследованные от класса javafx.scene.input.MouseEvent

Поля, унаследованные от класса javafx.event.Event

Поля, унаследованные от класса java.util.EventObject

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

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

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

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

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

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

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

ANY

MOUSE_DRAG_OVER

MOUSE_DRAG_RELEASED

MOUSE_DRAG_ENTERED_TARGET

MOUSE_DRAG_ENTERED

MOUSE_DRAG_EXITED_TARGET

MOUSE_DRAG_EXITED

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

MouseDragEvent

MouseDragEvent

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

getGestureSource

toString

copyFor

copyFor

getEventType