Интерфейс 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, 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/DropTargetListener.html