Класс 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)`	Этот метод возвращает `boolean`, указывающее, поддерживается ли указанное `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)

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

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

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, 2023, 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/21/docs/api/java.desktop/java/awt/dnd/DropTargetDragEvent.html