Класс DropTargetDragEvent

java.awt.dnd.DropTargetDragEvent

Все реализованные интерфейсы:: Serializable

public class DropTargetDragEvent extends DropTargetEvent

DropTargetDragEvent передаётся объекту DropTargetListener через методы dragEnter() и dragOver().

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

Действия перетаскивания источника — это побитовая маска DnDConstants, представляющая набор действий сброса, поддерживаемых источником перетаскивания для этой операции.

Действие сброса пользователя зависит от действий сброса, поддерживаемых источником перетаскивания, и действия сброса, выбранного пользователем. Пользователь может выбрать действие сброса, нажимая клавиши-модификаторы во время операции перетаскивания:

  Ctrl + Shift -> ACTION_LINK
  Ctrl         -> ACTION_COPY
  Shift        -> ACTION_MOVE

Если пользователь выбирает действие сброса, действие сброса пользователя — это одна из DnDConstants, представляющая выбранное действие сброса, если оно поддерживается источником перетаскивания, или DnDConstants.ACTION_NONE, если это действие не поддерживается источником перетаскивания.

Если пользователь не выбирает действие сброса, набор DnDConstants, представляющий набор действий сброса, поддерживаемых источником перетаскивания, проверяется на наличие DnDConstants.ACTION_MOVE, затем DnDConstants.ACTION_COPY, затем DnDConstants.ACTION_LINK; действием сброса пользователя становится первая найденная константа. Если константа не найдена, действием сброса пользователя становится DnDConstants.ACTION_NONE.

Начиная с:

1.2

См. также:

Краткое описание полей

Поля, объявленные в классе DropTargetEvent

context

Модификатор и тип	Поле	Описание
`protected DropTargetContext`	`context`	`DropTargetContext`, связанный с этим `DropTargetEvent`.

Поля, объявленные в классе EventObject

source

Модификатор и тип	Поле	Описание
`protected Object`	`source`	Объект, в котором изначально произошло событие.

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

Конструктор	Описание
`DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)`	Создаёт `DropTargetDragEvent`, используя `DropTargetContext` для этой операции, координаты точки активации курсора «перетаскивания» `Cursor` в системе координат `Component`, действие сброса пользователя и действия сброса источника.

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

Модификатор и тип	Метод	Описание
`void`	`acceptDrag(int dragOperation)`	Принимает перетаскивание.
`DataFlavor[]`	`getCurrentDataFlavors()`	Этот метод возвращает текущие `DataFlavor` из `DropTargetContext`.
`List<DataFlavor>`	`getCurrentDataFlavorsAsList()`	Этот метод возвращает текущие `DataFlavor` в виде `java.util.List`
`int`	`getDropAction()`	Этот метод возвращает действие сброса пользователя.
`Point`	`getLocation()`	Этот метод возвращает `Point`, указывающий текущее местоположение `Cursor` в системе координат `Component'`.
`int`	`getSourceActions()`	Этот метод возвращает действия сброса источника.
`Transferable`	`getTransferable()`	Этот метод возвращает объект Transferable, представляющий данные, связанные с текущей операцией перетаскивания.
`boolean`	`isDataFlavorSupported(DataFlavor df)`	Этот метод возвращает `boolean`, указывающий, поддерживается ли указанный `DataFlavor`.
`void`	`rejectDrag()`	Отклоняет перетаскивание после проверки `dropAction` или доступных типов `DataFlavor`.

Методы, объявленные в классе DropTargetEvent

getDropTargetContext

Модификатор и тип	Метод	Описание
`DropTargetContext`	`getDropTargetContext()`	Этот метод возвращает `DropTargetContext`, связанный с этим `DropTargetEvent`.

Методы, объявленные в классе EventObject

getSource, toString

Модификатор и тип	Метод	Описание
`Object`	`getSource()`	Объект, в котором изначально произошло событие.
`String`	`toString()`	Возвращает строковое представление этого EventObject.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, 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()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определённого промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определённого промежутка реального времени.

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

DropTargetDragEvent

public DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)

Создаёт DropTargetDragEvent, используя DropTargetContext для этой операции, координаты точки активации курсора «перетаскивания» Cursor в системе координат Component, действие сброса пользователя и действия сброса источника.

Параметры:: dtc — DropTargetContext для этой операции; cursorLocn — координаты точки активации курсора «перетаскивания» в системе координат Component; dropAction — действие сброса пользователя; srcActions — действия сброса источника
Вызывает исключение:: NullPointerException — если cursorLocn равен null; IllegalArgumentException — если dropAction не является одной из DnDConstants.; IllegalArgumentException — если srcActions не является побитовой маской DnDConstants.; IllegalArgumentException — если dtc равен null.

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

getLocation

public Point getLocation()

Этот метод возвращает Point, указывающий текущее местоположение Cursor в системе координат Component'.

Возвращает:: текущее местоположение курсора в координатах Component.

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

Этот метод возвращает текущие DataFlavor из DropTargetContext.

Возвращает:: текущие DataFlavors из DropTargetContext

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

Этот метод возвращает текущие DataFlavor в виде java.util.List

Возвращает:: java.util.List текущих DataFlavor

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

Этот метод возвращает boolean, указывающий, поддерживается ли указанный DataFlavor.

Параметры:: df — DataFlavor для проверки
Возвращает:: true, если конкретный DataFlavor поддерживается; в противном случае — false

getSourceActions

public int getSourceActions()

Этот метод возвращает действия сброса источника.

Возвращает:: действия сброса источника

getDropAction

public int getDropAction()

Этот метод возвращает действие сброса пользователя.

Возвращает:: действие сброса пользователя

getTransferable

public Transferable getTransferable()

Этот метод возвращает объект Transferable, представляющий данные, связанные с текущей операцией перетаскивания.

Возвращает:: Transferable, связанный с операцией перетаскивания
Вызывает исключение:: InvalidDnDOperationException — если данные, связанные с операцией перетаскивания, недоступны
Начиная с:: 1.5

acceptDrag

public void acceptDrag(int dragOperation)

Принимает перетаскивание. Этот метод следует вызывать из методов DropTargetListeners dragEnter, dragOver и dropActionChanged, если реализация хочет принять операцию из srcActions, отличную от выбранной пользователем, представленной dropAction.

Параметры:: dragOperation — операция, принимаемая целевым объектом

rejectDrag

public void rejectDrag()

Отклоняет перетаскивание после проверки dropAction или доступных типов DataFlavor.

© 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.