Интерфейс DropTargetListener

Все суперинтерфейсы:: EventListener

Все известные реализующие классы:: DropTarget, DropTargetAdapter

public interface DropTargetListener
extends EventListener

Интерфейс DropTargetListener является интерфейсом обратного вызова, используемым классом DropTarget для предоставления уведомлений об операциях перетаскивания, которые затрагивают объект DropTarget. Методы этого интерфейса могут быть реализованы для предоставления визуальной обратной связи «перетащить под» пользователю на протяжении всей операции перетаскивания и опускания.

Создайте объект слушателя, реализовав интерфейс, а затем зарегистрируйте его с DropTarget. При входе, перемещении или выходе указателя мыши из рабочей области места опускания для DropTarget, при изменении действия опускания и при опускании вызывается соответствующий метод в объекте слушателя, и ему передаётся DropTargetEvent.

Рабочая область места опускания для DropTarget — это часть геометрии связанного Component, которая не скрыта перекрывающимся верхнеуровневым окном или другим Component с более высоким порядком Z, имеющим связанное активное DropTarget.

Во время перетаскивания данные, связанные с текущей операцией перетаскивания, могут быть получены, вызвав getTransferable() на экземплярах DropTargetDragEvent, передаваемых методам слушателя.

Обратите внимание, что getTransferable() на экземпляре DropTargetDragEvent следует вызывать только в соответствующем методе слушателя, и все необходимые данные должны быть получены из возвращенного Transferable до возврата этого метода.

С:: 1.2

Методы

Модификатор и тип	Метод	Описание
`void`	`dragEnter(DropTargetDragEvent dtde)`	Вызывается во время выполнения операции перетаскивания, когда указатель мыши входит в рабочую область места опускания для `DropTarget`, зарегистрированного с этим слушателем.
`void`	`dragExit(DropTargetEvent dte)`	Вызывается во время выполнения операции перетаскивания, когда указатель мыши покинул рабочую область места опускания для `DropTarget`, зарегистрированного с этим слушателем.
`void`	`dragOver(DropTargetDragEvent dtde)`	Вызывается во время выполнения операции перетаскивания, когда указатель мыши всё ещё находится над рабочей областью места опускания для `DropTarget`, зарегистрированного с этим слушателем.
`void`	`drop(DropTargetDropEvent dtde)`	Вызывается, когда операция перетаскивания завершилась опусканием в рабочую область места опускания для `DropTarget`, зарегистрированного с этим слушателем.
`void`	`dropActionChanged(DropTargetDragEvent dtde)`	Вызывается, если пользователь изменил текущий жест опускания.

Методы

dragEnter

void dragEnter(DropTargetDragEvent dtde)

Вызывается во время выполнения операции перетаскивания, когда указатель мыши входит в рабочую область места опускания для DropTarget, зарегистрированного с этим слушателем.

Параметры:: dtde - DropTargetDragEvent

dragOver

void dragOver(DropTargetDragEvent dtde)

Вызывается во время выполнения операции перетаскивания, когда указатель мыши всё ещё находится над рабочей областью места опускания для DropTarget, зарегистрированного с этим слушателем.

Параметры:: dtde - DropTargetDragEvent

dropActionChanged

void dropActionChanged(DropTargetDragEvent dtde)

Вызывается, если пользователь изменил текущий жест опускания.

Параметры:: dtde - DropTargetDragEvent

dragExit

void dragExit(DropTargetEvent dte)

Вызывается во время выполнения операции перетаскивания, когда указатель мыши покинул рабочую область места опускания для DropTarget, зарегистрированного с этим слушателем.

Параметры:: dte - DropTargetEvent

drop

void drop(DropTargetDropEvent dtde)

Вызывается, когда операция перетаскивания завершилась опусканием в рабочую область места опускания для DropTarget, зарегистрированного с этим слушателем.

Этот метод отвечает за выполнение передачи данных, связанных с жестом. DropTargetDropEvent предоставляет средство получения объекта Transferable, представляющего объект(ы) данных, подлежащих передаче.

В этом методе DropTargetListener должен принять или отклонить опускание с помощью методов acceptDrop(int dropAction) или rejectDrop() параметра DropTargetDropEvent.

После acceptDrop(), но не ранее, метод getTransferable() DropTargetDropEvent может быть вызван, и передача данных может быть выполнена с помощью метода getTransferData() возвращенного Transferable.

По завершении опускания реализация этого метода должна сигнализировать об успехе/неудаче опускания, передав соответствующее значение boolean методу dropComplete(boolean success) объекта DropTargetDropEvent.

Примечание: передача данных должна быть завершена до вызова метода dropComplete(boolean success) объекта DropTargetDropEvent. После этого вызов метода getTransferData() объекта Transferable, возвращенного DropTargetDropEvent.getTransferable(), гарантируется, что будет успешным только в случае локальной передачи данных; то есть, только если DropTargetDropEvent.isLocalTransfer() возвращает true. В противном случае поведение вызова зависит от реализации.

Параметры:: dtde - DropTargetDropEvent