Класс DropTargetDragEvent

java.lang.Object
- java.util.EventObject
- - java.awt.dnd.DropTargetEvent
  - - 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
Возвращает:: поддерживается ли 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.