Класс 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, 2021, 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/17/docs/api/java.desktop/java/awt/dnd/DragSourceAdapter.html