Класс 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

Поля, объявленные в классе 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 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

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

getSource, toString

Методы, объявленные в классе 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 — местоположение точки активации курсора «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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/dnd/DropTargetDropEvent.html