Класс 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
Возвращает:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/dnd/DropTargetContext.html