Класс DragSourceAdapter

java.lang.Object

java.awt.dnd.DragSourceAdapter

Все реализуемые интерфейсы:: DragSourceListener, DragSourceMotionListener, EventListener

public abstract class DragSourceAdapter extends Object implements DragSourceListener, DragSourceMotionListener

Абстрактный класс-адаптер для получения событий источника перетаскивания. Методы этого класса пусты. Этот класс предназначен только для удобства создания объектов-слушателей.

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

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

Область приёма связана с предыдущим вызовом dragEnter(), если последний вызов dragEnter() для этого адаптера относится к этой области приёма и за ним не следует вызов dragExit() для этого адаптера.

Начиная с:

1.4

См. также:

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

DragSourceAdapter()

Модификатор	Конструктор	Описание
`protected`	Создаёт `DragSourceAdapter`.

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

Модификатор и тип	Метод	Описание
`void`	`dragDropEnd(DragSourceDropEvent dsde)`	Этот метод вызывается, чтобы сообщить о завершении операции перетаскивания.
`void`	`dragEnter(DragSourceDragEvent dsde)`	Вызывается, когда точка захвата курсора входит в платформозависимую область приёма.
`void`	`dragExit(DragSourceEvent dse)`	Вызывается, когда точка захвата курсора покидает платформозависимую область приёма.
`void`	`dragMouseMoved(DragSourceDragEvent dsde)`	Вызывается при каждом перемещении мыши во время операции перетаскивания.
`void`	`dragOver(DragSourceDragEvent dsde)`	Вызывается, когда точка захвата курсора перемещается над платформозависимой областью приёма.
`void`	`dropActionChanged(DragSourceDragEvent dsde)`	Вызывается, когда пользователь изменяет жест перетаскивания.

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

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

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

DragSourceAdapter

protected DragSourceAdapter()

Создаёт DragSourceAdapter.

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

dragEnter

public void dragEnter(DragSourceDragEvent dsde)

Вызывается, когда точка захвата курсора входит в платформозависимую область приёма. Этот метод вызывается при выполнении всех следующих условий:

Точка захвата курсора входит в рабочую часть платформозависимой области приёма.
Область приёма активна.
Область приёма принимает перетаскивание.

Определено в:: dragEnter в интерфейсе DragSourceListener
Параметры:: dsde — DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent dsde)

Вызывается, когда точка захвата курсора перемещается над платформозависимой областью приёма. Этот метод вызывается при выполнении всех следующих условий:

Точка захвата курсора переместилась, но всё ещё пересекает рабочую часть области приёма, связанной с предыдущим вызовом dragEnter().
Область приёма по-прежнему активна.
Область приёма принимает перетаскивание.

Определено в:: dragOver в интерфейсе DragSourceListener
Параметры:: dsde — DragSourceDragEvent

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent dsde)

Вызывается при каждом перемещении мыши во время операции перетаскивания.

Определено в:: dragMouseMoved в интерфейсе DragSourceMotionListener
Параметры:: dsde — DragSourceDragEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent dsde)

Вызывается, когда пользователь изменяет жест перетаскивания. Этот метод вызывается при изменении состояния устройства(устройств) ввода, с которым(и) взаимодействует пользователь. Обычно такими устройствами являются кнопки мыши или клавиши-модификаторы клавиатуры, с которыми взаимодействует пользователь.

Определено в:: dropActionChanged в интерфейсе DragSourceListener
Параметры:: dsde — DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent dse)

Вызывается, когда точка захвата курсора покидает платформозависимую область приёма. Этот метод вызывается при выполнении любого из следующих условий:

Точка захвата курсора больше не пересекает рабочую часть области приёма, связанной с предыдущим вызовом dragEnter().

ИЛИ

Область приёма, связанная с предыдущим вызовом dragEnter(), больше не активна.

ИЛИ

Область приёма, связанная с предыдущим вызовом dragEnter(), отклонила перетаскивание.

Определено в:: dragExit в интерфейсе DragSourceListener
Параметры:: dse — DragSourceEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent dsde)

Этот метод вызывается, чтобы сообщить о завершении операции перетаскивания. Метод getDropSuccess() класса DragSourceDropEvent можно использовать для определения состояния завершения. Метод getDropAction() возвращает операцию, выбранную областью приёма для выполнения операции перетаскивания. После завершения этого метода текущий DragSourceContext и связанные с ним ресурсы становятся недействительными.

Определено в:: dragDropEnd в интерфейсе DragSourceListener
Параметры:: dsde — DragSourceDropEvent

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