Spec-Zone.ru › OpenJDK 21

Класс 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
См. также:
  • DragSourceEvent
  • DragSourceListener
  • DragSourceMotionListener

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

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, 2023, 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/21/docs/api/java.desktop/java/awt/dnd/DragSourceAdapter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API