Класс DropTargetContext

java.lang.Object

java.awt.dnd.DropTargetContext

Все реализованные интерфейсы:: Serializable

public final class DropTargetContext extends Object implements Serializable

Создаётся DropTargetContext всякий раз, когда логический курсор, связанный с операцией перетаскивания и опускания, совпадает с видимой геометрией Component , связанной с DropTarget. DropTargetContext предоставляет механизм, позволяющий потенциальному получателю операции опускания как отображать пользователю надлежащую обратную связь при перетаскивании, так и выполнять последующую передачу данных при необходимости.

С момента:

1.2

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`DropTargetContext.TransferableProxy`	`TransferableProxy` — вспомогательный внутренний класс, реализующий интерфейс `Transferable` и служащий прокси для другого объекта `Transferable` , представляющего передачу данных для конкретной операции перетаскивания и опускания.

Краткое описание методов

Модификатор и тип	Метод	Описание
`protected void`	`acceptDrag(int dragOperation)`	Принимает перетаскивание.
`protected void`	`acceptDrop(int dropOperation)`	Вызывается для сигнализации о том, что опускание допустимо с использованием указанной операции.
`protected Transferable`	`createTransferableProxy(Transferable t, boolean local)`	Создаёт TransferableProxy для делегирования указанного Transferable.
`void`	`dropComplete(boolean success)`	Этот метод сигнализирует о завершении опускания и о его успешности.
`Component`	`getComponent()`	Этот метод возвращает `Component` , связанный с этим `DropTargetContext`.
`protected DataFlavor[]`	`getCurrentDataFlavors()`	Получает доступные DataFlavors операнда `Transferable` данной операции.
`protected List<DataFlavor>`	`getCurrentDataFlavorsAsList()`	Этот метод возвращает текущие доступные DataFlavors операнда `Transferable` как `java.util.List`.
`DropTarget`	`getDropTarget()`	Этот метод возвращает `DropTarget` , связанный с этим `DropTargetContext`.
`protected int`	`getTargetActions()`	Этот метод возвращает `int` , представляющий текущие действия, которые этот `DropTarget` будет принимать.
`protected Transferable`	`getTransferable()`	Получает операнд Transferable (прокси) этой операции.
`protected boolean`	`isDataFlavorSupported(DataFlavor df)`	Этот метод возвращает `boolean` , указывающий, поддерживается ли данный `DataFlavor` этим `DropTargetContext`.
`protected void`	`rejectDrag()`	Отклоняет перетаскивание.
`protected void`	`rejectDrop()`	Вызывается для сигнализации о том, что опускание недопустимо.
`protected void`	`setTargetActions(int actions)`	Этот метод устанавливает текущие действия, допустимые для этого `DropTarget`.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание методов

getDropTarget

public DropTarget getDropTarget()

Этот метод возвращает DropTarget , связанный с этим DropTargetContext.

Возвращает:: DropTarget , связанный с этим DropTargetContext

getComponent

public Component getComponent()

Этот метод возвращает Component , связанный с этим DropTargetContext.

Возвращает:: Компонент, связанный с этим контекстом

setTargetActions

protected void setTargetActions(int actions)

Этот метод устанавливает текущие действия, допустимые для этого DropTarget.

Параметры:: actions - int , представляющий поддерживаемое(ые) действие(я)

getTargetActions

protected int getTargetActions()

Этот метод возвращает int , представляющий текущие действия, которые этот DropTarget будет принимать.

Возвращает:: текущие допустимые действия для этого DropTarget

dropComplete

public void dropComplete(boolean success) throws InvalidDnDOperationException

Этот метод сигнализирует о завершении опускания и о его успешности.

Параметры:: success - true для успешного опускания, false — в противном случае
Исключения:: InvalidDnDOperationException - если опускание не ожидается/неактуально

acceptDrag

protected void acceptDrag(int dragOperation)

Принимает перетаскивание.

Параметры:: dragOperation - поддерживаемое(ые) действие(я)

rejectDrag

protected void rejectDrag()

Отклоняет перетаскивание.

acceptDrop

protected void acceptDrop(int dropOperation)

Вызывается для сигнализации о том, что опускание допустимо с использованием указанной операции. Должно вызываться во время вызова метода DropTargetListener.drop.

Параметры:: dropOperation - поддерживаемое(ые) действие(я)

rejectDrop

protected void rejectDrop()

Вызывается для сигнализации о том, что опускание недопустимо. Должно вызываться во время вызова метода DropTargetListener.drop.

getCurrentDataFlavors

protected DataFlavor[] getCurrentDataFlavors()

Получает доступные DataFlavors операнда Transferable данной операции.

Возвращает:: DataFlavor[] , содержащий поддерживаемые DataFlavor операнда Transferable.

getCurrentDataFlavorsAsList

protected List<DataFlavor> getCurrentDataFlavorsAsList()

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

Возвращает:: текущие доступные DataFlavors как java.util.List

isDataFlavorSupported

protected boolean isDataFlavorSupported(DataFlavor df)

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

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

getTransferable

protected Transferable getTransferable() throws InvalidDnDOperationException

Получает операнд Transferable (прокси) этой операции.

Возвращает:: Transferable
Исключения:: InvalidDnDOperationException - если перетаскивание не ожидается/неактуально

createTransferableProxy

protected Transferable createTransferableProxy(Transferable t, boolean local)

Создаёт TransferableProxy для делегирования указанного Transferable.

Параметры:: t - Transferable для делегирования; local - true , если t представляет результат локальной операции перетаскивания и опускания.
Возвращает:: новый экземпляр TransferableProxy.

© 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/DropTargetContext.html