Spec-Zone.ru › OpenJDK 24

Класс 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)
Вызывается, если пользователь изменил текущее жестикулирование перетаскивания.

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

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

Методы, объявленные в интерфейсе java.awt.dnd.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

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

Spec-Zone.ru

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