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

dragOver

void dragOver(DropTargetDragEvent dtde)

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

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

dropActionChanged

void dropActionChanged(DropTargetDragEvent dtde)

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

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

dragExit

void dragExit(DropTargetEvent dte)

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

Параметры:: dte - the 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 - the 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/dnd/DropTargetListener.html