Класс 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()`	возвращает доступные DataFlavor операнда `Transferable` этой операции.
`protected List<DataFlavor>`	`getCurrentDataFlavorsAsList()`	Этот метод возвращает текущие доступные DataFlavor операнда `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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API планируется удалить в будущей версии. Финализация устарела и планируется к удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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()

возвращает доступные DataFlavor операнда Transferable этой операции.

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

getCurrentDataFlavorsAsList

protected List<DataFlavor> getCurrentDataFlavorsAsList()

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

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