Интерфейс 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

© 1993, 2020, 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.