Класс DropTargetDropEvent

java.awt.dnd.DropTargetDropEvent

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

public class DropTargetDropEvent extends DropTargetEvent

Данный класс DropTargetDropEvent доставляется методом DropTargetListener drop().

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

Действия при падении источника — это битовая маска 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

См. также:

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

Поля, объявленные в классе java.awt.dnd.DropTargetEvent

context

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

source

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

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

Конструктор	Описание
`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 для данной операции, расположение точки Cursor перетаскиваемого объекта в координатах Component, выбранное пользователем действие при падении и текущий набор действий, поддерживаемых источником.

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()`	Отклоняет падение.

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

getDropTargetContext

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

getSource, toString

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

DropTargetDropEvent

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

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

Параметры:: dtc - Контекст операции DropTargetContext; cursorLocn - Координаты точки "захвата" курсора "перетаскивания" в системе координат компонента; 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)

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

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

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

getLocation

public Point getLocation()

Этот метод возвращает координаты текущего расположения Point в системе координат компонента.

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

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

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

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

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

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

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

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

Этот метод возвращает значение, указывающее, поддерживается ли указанный 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 - флаг, указывающий, что передача данных (опускание) завершена.

isLocalTransfer

public boolean isLocalTransfer()

Этот метод возвращает значение, указывающее, находится ли источник в той же 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/dnd/DropTargetDropEvent.html