Spec-Zone.ru › OpenJDK 25

Класс DropTargetAdapter

java.lang.Object
java.awt.dnd.DropTargetAdapter
Все реализуемые интерфейсы:
DropTargetListener, EventListener
public abstract class DropTargetAdapter extends Object implements DropTargetListener
Абстрактный класс-адаптер для получения событий целевого объекта перетаскивания. Методы этого класса пусты. Этот класс существует только для удобства создания объектов-слушателей.

Наследуйте этот класс, чтобы создать слушатель DropTargetEvent, и переопределите методы для интересующих вас событий. (Если вы реализуете интерфейс DropTargetListener, необходимо определить все его методы. Этот абстрактный класс задает пустую реализацию для каждого метода, кроме drop(DropTargetDropEvent), поэтому вам нужно определить только методы для событий, которые вас интересуют.) Необходимо предоставить реализацию как минимум для drop(DropTargetDropEvent). У этого метода не может быть пустой реализации, поскольку его спецификация требует либо принять, либо отклонить перетаскивание и, в случае принятия, указать, было ли оно успешным.

Создайте объект-слушатель с помощью расширенного класса, а затем зарегистрируйте его в DropTarget. Когда перетаскиваемый объект входит в рабочую область сайта назначения, перемещается над ней или покидает ее для этого DropTarget, когда меняется действие сброса и когда происходит сброс, вызывается соответствующий метод объекта-слушателя, которому передается DropTargetEvent.

Рабочая область сайта назначения для DropTarget — это часть геометрии связанного с ним Component, не перекрытая наложенным окном верхнего уровня или другим Component, расположенным выше в Z-порядке и связанным с активным DropTarget.

Во время перетаскивания данные, связанные с текущей операцией перетаскивания, можно получить, вызвав getTransferable() для экземпляров DropTargetDragEvent, переданных методам слушателя.

Обратите внимание, что getTransferable() для экземпляра DropTargetDragEvent следует вызывать только в соответствующем методе слушателя, а все необходимые данные из возвращенного Transferable следует получить до возврата из этого метода.

Начиная с версии:
1.4
См. также:
  • DropTargetEvent
  • DropTargetListener

Краткое описание конструкторов

DropTargetAdapter()
Модификатор Конструктор Описание
protected
Создает DropTargetAdapter.

Краткое описание методов

Модификатор и тип Метод Описание
void dragEnter(DropTargetDragEvent dtde)
Вызывается во время перетаскивания, когда указатель мыши входит в рабочую область сайта назначения для DropTarget, зарегистрированного с помощью этого слушателя.
void dragExit(DropTargetEvent dte)
Вызывается во время перетаскивания, когда указатель мыши покидает рабочую область сайта назначения для DropTarget, зарегистрированного с помощью этого слушателя.
void dragOver(DropTargetDragEvent dtde)
Вызывается во время перетаскивания, пока указатель мыши остается над рабочей областью сайта назначения для DropTarget, зарегистрированного с помощью этого слушателя.
void dropActionChanged(DropTargetDragEvent dtde)
Вызывается, если пользователь изменил текущий жест сброса.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе DropTargetListener

drop

Подробное описание конструкторов

DropTargetAdapter

protected DropTargetAdapter()
Создает DropTargetAdapter.

Подробное описание методов

dragEnter

public void dragEnter(DropTargetDragEvent dtde)
Вызывается во время перетаскивания, когда указатель мыши входит в рабочую область сайта назначения для DropTarget, зарегистрированного с помощью этого слушателя.
Определено в:
dragEnter в интерфейсе DropTargetListener
Параметры:
dtde — DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent dtde)
Вызывается во время перетаскивания, пока указатель мыши остается над рабочей областью сайта назначения для DropTarget, зарегистрированного с помощью этого слушателя.
Определено в:
dragOver в интерфейсе DropTargetListener
Параметры:
dtde — DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)
Вызывается, если пользователь изменил текущий жест сброса.
Определено в:
dropActionChanged в интерфейсе DropTargetListener
Параметры:
dtde — DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent dte)
Вызывается во время перетаскивания, когда указатель мыши покидает рабочую область сайта назначения для DropTarget, зарегистрированного с помощью этого слушателя.
Определено в:
dragExit в интерфейсе DropTargetListener
Параметры:
dte — DropTargetEvent

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, общие обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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/DropTargetAdapter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API