Spec-Zone.ru › OpenJDK 27

Класс 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
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли этот объект какому-либо другому.
protected void finalize()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Финализация устарела и может быть удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt.
final void wait(long timeoutMillis)
Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного времени.
final void wait(long timeoutMillis, int nanos)
Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного времени.

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

drop
Модификатор и тип Метод Описание
void drop(DropTargetDropEvent dtde)
Вызывается, когда операция перетаскивания завершается сбросом в рабочей области сайта перетаскивания для DropTarget, зарегистрированного у этого прослушивателя.

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

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, 2026, 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.

Spec-Zone.ru

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