Интерфейс DropTargetListener

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

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

public interface DropTargetListener extends EventListener

Интерфейс DropTargetListener — это интерфейс обратного вызова, который класс DropTarget использует для уведомления об операциях DnD, связанных с объектом 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, 2025, 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/25/docs/api/java.desktop/java/awt/dnd/DropTargetListener.html