Класс DropTargetDropEvent

java.awt.dnd.DropTargetDropEvent

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

public class DropTargetDropEvent extends DropTargetEvent

Объект DropTargetDropEvent передаётся через метод DropTargetListener drop().

Объект 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

См. также:

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

Поля, объявленные в классе 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 для данной операции, положения горячей точки перетаскиваемого объекта в координатах 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 для данной операции, положения горячей точки перетаскиваемого объекта в координатах 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, 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/DropTargetDropEvent.html