Класс DropTargetDragEvent

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.

Конструкторы

DropTargetDragEvent

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

Параметры:

dtc - DropTargetContext для данной операции

cursorLocn - Координаты точки "Курсор" перетаскивания в системе координат компонента

dropAction - Выбранное пользователем действие по сбросу

srcActions - Действия по сбросу источника

Исключения:

NullPointerException - если cursorLocn равно null

IllegalArgumentException - если dropAction не является одним из DnDConstants.

IllegalArgumentException - если srcActions не является битовой маской DnDConstants.

IllegalArgumentException - если dtc равно null.

Методы

getLocation

public Point getLocation()

Возвращает:

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

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

Возвращает:

текущие DataFlavors из DropTargetContext

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

Возвращает:

список текущих DataFlavor.

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

Параметры:

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 типов.