Интерфейс DragSourceListener

Все суперинтерфейсы:: EventListener

Все известные реализующие классы:: DragSourceAdapter, DragSourceContext

public interface DragSourceListener extends EventListener

Интерфейс DragSourceListener определяет интерфейс событий для инициаторов операций перетаскивания, позволяющий отслеживать состояние жеста пользователя и предоставлять пользователю соответствующую обратную связь при перетаскивании на протяжении всей операции перетаскивания.

Сайт сброса связан с предыдущим вызовом dragEnter(), если последний вызов dragEnter() для этого слушателя:

соответствует этому сайту сброса и
за ним не следует вызов dragExit() для этого слушателя.

Начиная с:: 1.2

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

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

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

dragEnter

void dragEnter(DragSourceDragEvent dsde)

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

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

Параметры:: dsde — DragSourceDragEvent

dragOver

void dragOver(DragSourceDragEvent dsde)

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

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

Параметры:: dsde — DragSourceDragEvent

dropActionChanged

void dropActionChanged(DragSourceDragEvent dsde)

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

Параметры:: dsde — DragSourceDragEvent

dragExit

void dragExit(DragSourceEvent dse)

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

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

ИЛИ

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

ИЛИ

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

Параметры:: dse — DragSourceEvent

dragDropEnd

void dragDropEnd(DragSourceDropEvent dsde)

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

Параметры:: 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/DragSourceListener.html