Класс 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_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()`	Этот метод возвращает `int`, указывающий, находится ли источник в той же 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 для данной операции, расположения активной области перетаскивания Cursor в координатах Component, выбранного пользователем действия падения, и набора действий, поддерживаемых источником. По умолчанию, этот конструктор предполагает, что целевой объект не находится в той же виртуальной машине, что и источник; то есть, isLocalTransfer() вернёт false.

Параметры:: dtc - DropTargetContext для данной операции; cursorLocn - Расположение активной области перетаскивания в координатах 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)

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

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

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)

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

Параметры:: df - проверяемый DataFlavor
Возвращает:: доступен ли указанный DataFlavor у источника

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, что и цель.

Возвращает:: является ли источник частью той же JVM

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/dnd/DropTargetDropEvent.html