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

См. также:

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

Поля, объявленные в классе DropTargetEvent

context

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

source

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

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

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

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)`	Этот метод возвращает `boolean`, указывающее, поддерживается ли указанное `DataFlavor`.
`void`	`rejectDrag()`	Отклоняет перетаскивание после проверки `dropAction` или доступных типов `DataFlavor`.

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

getDropTargetContext

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

getSource, toString

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

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

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

DropTargetDragEvent

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

Параметры:: dtc — контекст DropTargetContext для этой операции; cursorLocn — местоположение точки активации курсора «перетаскиваемого» объекта в координатах Component; 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

Возвращает:: java.util.List текущих DataFlavor

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

Этот метод возвращает boolean, указывающее, поддерживается ли указанный 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/dnd/DropTargetDragEvent.html