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

Методы, объявленные в классе java.lang.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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/dnd/DragSourceAdapter.html