Интерфейс 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 - the DragSourceDragEvent

dragOver

void dragOver(DragSourceDragEvent dsde)

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

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

Параметры:: dsde - the DragSourceDragEvent

dropActionChanged

void dropActionChanged(DragSourceDragEvent dsde)

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

Параметры:: dsde - the DragSourceDragEvent

dragExit

void dragExit(DragSourceEvent dse)

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

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

ИЛИ

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

ИЛИ

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

Параметры:: dse - the DragSourceEvent

dragDropEnd

void dragDropEnd(DragSourceDropEvent dsde)

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

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