Класс DropTargetDropEvent

java.awt.dnd.DropTargetDropEvent

Все реализуемые интерфейсы:: Serializable

public class DropTargetDropEvent extends DropTargetEvent

DropTargetDropEvent передается через метод drop() DropTargetListener.

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

Действия перетаскивания источника — это побитовая маска 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`	Объект, на котором первоначально произошло событие Event.

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

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

Конструктор	Описание
`DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)`	Создает `DropTargetDropEvent`, используя `DropTargetContext` для этой операции, расположение точки активации перетаскивания `Cursor` в координатах `Component`, текущее выбранное действие перетаскивания пользователя и текущий набор действий, поддерживаемых источником.
`DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)`	Создает `DropTargetEvent`, используя `DropTargetContext` для этой операции, расположение точки активации перетаскивания `Cursor` в координатах `Component`, текущее выбранное действие перетаскивания пользователя, текущий набор действий, поддерживаемых источником, и `boolean`, указывающий, находится ли источник в той же JVM, что и целевой объект.

DropTargetDropEvent(DropTargetContext dtc,
 Point cursorLocn,
 int dropAction,
 int srcActions)

DropTargetDropEvent(DropTargetContext dtc,
 Point cursorLocn,
 int dropAction,
 int srcActions,
 boolean isLocal)

Создает DropTargetEvent, используя DropTargetContext для этой операции, расположение точки активации перетаскивания Cursor в координатах Component, текущее выбранное действие перетаскивания пользователя, текущий набор действий, поддерживаемых источником, и boolean, указывающий, находится ли источник в той же JVM, что и целевой объект.

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

Модификатор и тип	Метод	Описание
`void`	`acceptDrop(int dropAction)`	Принять перетаскивание, используя указанное действие.
`void`	`dropComplete(boolean success)`	Этот метод уведомляет `DragSource` о завершении передачи перетаскиваемых данных.
`DataFlavor[]`	`getCurrentDataFlavors()`	Этот метод возвращает текущие DataFlavors.
`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` из источника.
`boolean`	`isLocalTransfer()`	Этот метод возвращает `boolean`, указывающий, находится ли источник в той же JVM, что и целевой объект.
`void`	`rejectDrop()`	Отклонить перетаскивание.

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

getDropTargetContext

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

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

getSource, toString

Модификатор и тип	Метод	Описание
`Object`	`getSource()`	Объект, на котором первоначально произошло событие Event.
`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()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

DropTargetDropEvent

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

Создает DropTargetDropEvent, используя DropTargetContext для этой операции, расположение точки активации перетаскивания Cursor в координатах Component, текущее выбранное действие перетаскивания пользователя и текущий набор действий, поддерживаемых источником. По умолчанию этот конструктор предполагает, что целевой объект находится не в той же виртуальной машине, что и источник; то есть isLocalTransfer() вернет false.

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

DropTargetDropEvent

public DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)

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

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

getLocation

public Point getLocation()

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

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

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

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

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

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

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

Возвращает:: текущие доступные DataFlavors в виде java.util.List

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, связанный с перетаскиванием

acceptDrop

public void acceptDrop(int dropAction)

Принимает перетаскивание, используя указанное действие.

Параметры:: dropAction — указанное действие

rejectDrop

public void rejectDrop()

Отклоняет перетаскивание.

dropComplete

public void dropComplete(boolean success)

Этот метод уведомляет DragSource о завершении передачи перетаскиваемых данных.

Параметры:: success — boolean, указывающий, что передача перетаскиваемых данных завершена.

isLocalTransfer

public boolean isLocalTransfer()

Этот метод возвращает boolean, указывающий, находится ли источник в той же JVM, что и целевой объект.

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

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