Класс 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` для данной операции, расположения "горячей точки" перетаскивания в координатах `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 для данной операции, расположения "горячей точки" перетаскивания в координатах 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, 2021, 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/17/docs/api/java.desktop/java/awt/dnd/DropTargetDragEvent.html