Класс 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)`	вызывается, чтобы сообщить, что сброс допустим с использованием указанной операции. Должен вызываться во время вызова метода DropTargetListener.drop.
`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()`	вызывается, чтобы сообщить, что сброс недопустим. Должен вызываться во время вызова метода DropTargetListener.drop.
`protected void`	`setTargetActions(int actions)`	Этот метод задает текущие действия, допустимые для этого `DropTarget`.

Методы, объявленные в классе 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 для проверки
Возвращает:: true, если указанный DataFlavor поддерживается, иначе false

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