Класс DropTargetDragEvent

java.awt.dnd.DropTargetDragEvent

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

public class DropTargetDragEvent extends DropTargetEvent

Объект класса DropTargetDragEvent доставляется целевому элементу DropTargetListener через методы dragEnter() и dragOver().

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

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

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

   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.awt.dnd.DropTargetEvent

context

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

source

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

Конструктор	Описание
`DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)`	Создает объект `DropTargetDragEvent` с заданными параметрами: контекстом операции `DropTargetContext`, положением "точки перетаскивания" `Cursor` относительно координат `Component`, действием пользователя и действиями источника.

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

Модификатор и тип	Метод	Описание
`void`	`acceptDrag(int dragOperation)`	Принимает перетаскивание.
`DataFlavor[]`	`getCurrentDataFlavors()`	Этот метод возвращает текущие `DataFlavor` из `DropTargetContext`.
`List<DataFlavor>`	`getCurrentDataFlavorsAsList()`	Этот метод возвращает текущие `DataFlavor` в виде `java.util.List`
`int`	`getDropAction()`	Этот метод возвращает действие пользователя.
`Point`	`getLocation()`	Этот метод возвращает `Point`, указывающий текущее положение `Cursor` в координатах `Component'`.
`int`	`getSourceActions()`	Этот метод возвращает действия источника.
`Transferable`	`getTransferable()`	Этот метод возвращает объект Transferable, представляющий данные, связанные с текущей операцией перетаскивания.
`boolean`	`isDataFlavorSupported(DataFlavor df)`	Этот метод возвращает значение, указывающее, поддерживается ли указанный `DataFlavor`.
`void`	`rejectDrag()`	Отклоняет перетаскивание, проверив либо `dropAction`, либо доступные типы `DataFlavor`.

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

getDropTargetContext

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

getSource, toString

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

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

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

DropTargetDragEvent

public DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)

Создает объект DropTargetDragEvent с заданными параметрами: контекстом операции DropTargetContext, положением "точки перетаскивания" Cursor относительно координат Component, действием пользователя и действиями источника.

Параметры:: dtc - Контекст операции DropTargetContext; cursorLocn - Положение "точки перетаскивания" курсора в координатах компонента; dropAction - Действие пользователя; srcActions - Действия источника
Исключения:: NullPointerException - если cursorLocn равно null; IllegalArgumentException - если dropAction не является одним из DnDConstants.; IllegalArgumentException - если srcActions не является битовой маской DnDConstants.; IllegalArgumentException - если dtc равно null.

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

getLocation

public Point getLocation()

Этот метод возвращает Point, указывающий текущее положение Cursor в координатах Component'.

Возвращает:: текущее положение курсора в координатах Component.

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

Этот метод возвращает текущие DataFlavor из DropTargetContext.

Возвращает:: текущие DataFlavors из DropTargetContext

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

Этот метод возвращает текущие DataFlavor в виде java.util.List

Возвращает:: список текущих DataFlavor

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

Этот метод возвращает значение, указывающее, поддерживается ли указанный DataFlavor.

Параметры:: df - проверяемый DataFlavor
Возвращает:: true, если конкретный DataFlavor поддерживается, в противном случае false

getSourceActions

public int getSourceActions()

Этот метод возвращает действия источника.

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

getDropAction

public int getDropAction()

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

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

getTransferable

public Transferable getTransferable()

Этот метод возвращает объект Transferable, представляющий данные, связанные с текущей операцией перетаскивания.

Возвращает:: объект Transferable, связанный с операцией перетаскивания
Исключения:: InvalidDnDOperationException - если данные, связанные с операцией перетаскивания, недоступны
С момента:: 1.5

acceptDrag

public void acceptDrag(int dragOperation)

Принимает перетаскивание. Этот метод должен вызываться из методов DropTargetListeners dragEnter, dragOver и dropActionChanged, если реализация хочет принять операцию из srcActions, отличную от выбранной пользователем, представленной dropAction.

Параметры:: dragOperation - операция, принятая целевым элементом

rejectDrag

public void rejectDrag()

Отклоняет перетаскивание, проверив либо dropAction, либо доступные типы DataFlavor.

© 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/DropTargetDragEvent.html