Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, запланировано к удалению: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного времени.

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

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.