Класс DragSourceDragEvent

java.awt.dnd.DragSourceDragEvent

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

public class DragSourceDragEvent extends DragSourceEvent

Содержит событие перетаскивания, которое передается от источника перетаскивания к целевому объекту через механизм перетаскивания.

Объект DragSourceDragEvent сообщает о действии падения для целевого объекта и действии падения для пользователя, которые отражают текущее состояние операции перетаскивания.

Действие падения для целевого объекта — это одно из DnDConstants, которое представляет выбранное действие падения текущим целевым объектом, если это действие поддерживается источником перетаскивания, или DnDConstants.ACTION_NONE, если это действие не поддерживается источником перетаскивания.

Действие падения для пользователя зависит от действий падения, поддерживаемых источником перетаскивания, и действия падения, выбранного пользователем. Пользователь может выбрать действие падения, нажимая модификаторные клавиши во время операции перетаскивания:

   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE

Если пользователь выбирает действие падения, действие падения для пользователя — это одно из DnDConstants, которое представляет выбранное действие падения, если это действие поддерживается источником перетаскивания, или DnDConstants.ACTION_NONE, если это действие не поддерживается источником перетаскивания.

Если пользователь не выбирает действие падения, проверяется множество DnDConstants, представляющее набор поддерживаемых действий падения для источника перетаскивания, в поиске DnDConstants.ACTION_MOVE, затем DnDConstants.ACTION_COPY, затем DnDConstants.ACTION_LINK, и действие падения для пользователя — первая найденная константа. Если константа не найдена, действие падения для пользователя — DnDConstants.ACTION_NONE.

С момента:

1.2

См. также:

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

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

source

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

Конструктор	Описание
`DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)`	Конструирует объект `DragSourceDragEvent`.
`DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)`	Конструирует объект `DragSourceDragEvent`, задавая указанный `DragSourceContext`, действие падения пользователя, действие падения целевого объекта, модификаторы и координаты.

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

Модификатор и тип	Метод	Описание
`int`	`getDropAction()`	Этот метод возвращает логическое пересечение действия падения целевого объекта и набора действий падения, поддерживаемых источником перетаскивания.
`int`	`getGestureModifiers()`	Этот метод возвращает объект, представляющий текущее состояние модификаторов устройства ввода, связанных с жестом пользователя.
`int`	`getGestureModifiersEx()`	Этот метод возвращает объект, представляющий текущее состояние расширенных модификаторов устройства ввода, связанных с жестом пользователя.
`int`	`getTargetActions()`	Этот метод возвращает действие падения целевого объекта.
`int`	`getUserAction()`	Этот метод возвращает действие падения пользователя.

Методы, объявленные в классе java.awt.dnd.DragSourceEvent

getDragSourceContext, getLocation, getX, getY

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

getSource, toString

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

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

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

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)

Создает экземпляр класса DragSourceDragEvent. Этот класс обычно создается DragSourceContextPeer, а не напрямую кодом клиента. Координаты для этого DragSourceDragEvent не указаны, поэтому getLocation вернёт null для этого события.

Аргументы dropAction и action должны быть одним из DnDConstants, представляющим отдельное действие. Аргумент modifiers должен быть либо побитовой маской старых констант java.awt.event.InputEvent.*_MASK, либо побитовой маской расширенных констант java.awt.event.InputEvent.*_DOWN_MASK. Данный конструктор не генерирует исключений для некорректных dropAction, action и modifiers.

Параметры:

dsc - DragSourceContext, который будет управлять уведомлениями для этого события.

dropAction - действие сбрасывания пользователя.

action - целевое действие сбрасывания.

modifiers - модификаторы клавиш, нажатые во время события (Shift, Ctrl, Alt, Meta). Должны использоваться либо расширенные модификаторы _DOWN_MASK, либо старые _MASK, но оба типа модификаторов не должны смешиваться в одном событии. Использование расширенных модификаторов предпочтительно.

Исключения:

IllegalArgumentException - если dsc является null.

См. также:

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)

Создает экземпляр DragSourceDragEvent, задавая указанные DragSourceContext, действие сбрасывания пользователя, целевое действие сбрасывания, модификаторы и координаты.

Параметры:

dsc - DragSourceContext, связанный с этим событием.

dropAction - действие сбрасывания пользователя.

action - целевое действие сбрасывания.

x - горизонтальная координата курсора.

y - вертикальная координата курсора.

Исключения:

IllegalArgumentException - если dsc является null.

С:

1.4

См. также:

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

getTargetActions

public int getTargetActions()

Этот метод возвращает целевое действие сбрасывания.

Возвращает:: целевое действие сбрасывания.

getGestureModifiers

public int getGestureModifiers()

Этот метод возвращает int, представляющий текущее состояние модификаторов устройства ввода, связанных с жестом пользователя. Обычно это клавиши мыши или модификаторы клавиатуры.

Если modifiers, переданные в конструктор, некорректны, этот метод возвращает их без изменений.

Возвращает:: текущее состояние модификаторов устройства ввода

getGestureModifiersEx

public int getGestureModifiersEx()

Этот метод возвращает int, представляющий текущее состояние расширенных модификаторов устройства ввода, связанных с жестом пользователя. См. InputEvent.getModifiersEx()

Если modifiers, переданные в конструктор, некорректны, этот метод возвращает их без изменений.

Возвращает:: текущее состояние расширенных модификаторов устройства ввода
С:: 1.4

getUserAction

public int getUserAction()

Этот метод возвращает действие сбрасывания пользователя.

Возвращает:: действие сбрасывания пользователя.

getDropAction

public int getDropAction()

Этот метод возвращает логическое пересечение целевого действия сбрасывания и набора действий сбрасывания, поддерживаемых источником перетаскивания.

Возвращает:: логическое пересечение целевого действия сбрасывания и набора действий сбрасывания, поддерживаемых источником перетаскивания.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/dnd/DragSourceDragEvent.html