Класс DropTargetDropEvent

Все реализованные интерфейсы:
Serializable
public class DropTargetDropEvent
extends DropTargetEvent

Объект DropTargetDropEvent доставляется методом 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, что и целевой.

Методы

Модификатор и тип Метод Описание
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, используя данные о текущей операции, местоположение активной области перетаскивания в координатах целевого компонента, выбранное пользователем действие опускания и набор действий, поддерживаемых источником. По умолчанию, предполагается, что целевой компонент находится не в той же виртуальной машине, что и источник; то есть, isLocalTransfer() вернёт false.

Параметры:
dtc - Контекст для текущей операции
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, используя данные о текущей операции, местоположение активной области перетаскивания в координатах целевого компонента, выбранное пользователем действие опускания, набор действий, поддерживаемых источником, и флаг, указывающий, находится ли источник в той же виртуальной машине, что и целевой компонент.

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

Методы

getLocation

public Point getLocation()

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

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

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

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

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

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

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

Возвращает:
доступные 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()

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

Возвращает:
True, если источник находится в той же виртуальной машине.

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

Spec-Zone .ru
спецификации, руководства, описания, API