Интерфейс 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, 2023, 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/21/docs/api/java.desktop/java/awt/dnd/DropTargetListener.html