Класс DragSourceDragEvent

java.awt.dnd.DragSourceDragEvent

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

public class DragSourceDragEvent extends DragSourceEvent

Объект DragSourceDragEvent передается от DragSourceContextPeer через DragSourceContext объекту DragSourceListener, зарегистрированному в этом DragSourceContext и связанному с ним DragSource.

Объект 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

См. также:

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

Поля, объявленные в классе 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`, представляющий текущее состояние модификаторов устройства ввода, связанных с жестом пользователя.
`int`	`getGestureModifiersEx()`	Этот метод возвращает `int`, представляющий текущее состояние расширенных модификаторов устройства ввода, связанных с жестом пользователя.
`int`	`getTargetActions()`	Этот метод возвращает целевое действие сброса.
`int`	`getUserAction()`	Этот метод возвращает действие сброса пользователя.

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

getDragSourceContext, getLocation, getX, getY

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

getSource, toString

Методы, объявленные в классе 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/dnd/DragSourceDragEvent.html