Класс DropTargetDropEvent

java.lang.Object
- java.util.EventObject
- - java.awt.dnd.DropTargetEvent
  - - 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` указывающего, находится ли источник в той же виртуальной машине, что и целевой объект.

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

Методы

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

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

isLocalTransfer

public boolean isLocalTransfer()

Этот метод возвращает int указывающее, находится ли источник в той же JVM, что и целевой объект.

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

© 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.