Класс DropTargetContext

java.lang.Object
- java.awt.dnd.DropTargetContext

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

public class DropTargetContext
extends Object
implements Serializable

Объект класса DropTargetContext создаётся всякий раз, когда логический курсор, связанный с операцией перетаскивания и опускания, совпадает с видимой геометрией объекта, связанного с операцией перетаскивания и опускания. Объект 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()`	Этот метод возвращает объект DropTarget, связанный с этим объектом DropTargetContext.
`protected DataFlavor[]`	`getCurrentDataFlavors()`	Получить доступные DataFlavors операнда `Transferable` этой операции.
`protected List<DataFlavor>`	`getCurrentDataFlavorsAsList()`	Этот метод возвращает текущие доступные DataFlavors операнда `Transferable` как список `java.util.List`.
`DropTarget`	`getDropTarget()`	Этот метод возвращает объект DropTarget, связанный с этим объектом DropTargetContext.
`protected int`	`getTargetActions()`	Этот метод возвращает значение, представляющее текущие действия, которые этот объект DropTargetContext будет принимать.
`protected Transferable`	`getTransferable()`	Получить объект Transferable (прокси) операнда этой операции.
`protected boolean`	`isDataFlavorSupported(DataFlavor df)`	Этот метод возвращает значение, указывающее, поддерживается ли данный DataFlavor этим объектом DropTargetContext.
`protected void`	`rejectDrag()`	Отклонить перетаскивание.
`protected void`	`rejectDrop()`	Вызывается для сигнализации о том, что опускание недопустимо.
`protected void`	`setTargetActions(int actions)`	Этот метод устанавливает текущие действия, допустимые для этого объекта DropTargetContext.

Методы, объявленные в классе 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()

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

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

setTargetActions

protected void setTargetActions(int actions)

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

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

getTargetActions

protected int getTargetActions()

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

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

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)

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

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

rejectDrop

protected void rejectDrop()

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

getCurrentDataFlavors

protected DataFlavor[] getCurrentDataFlavors()

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

Возвращает:: объект, содержащий поддерживаемые DataFlavors операнда Transferable.

getCurrentDataFlavorsAsList

protected List<DataFlavor> getCurrentDataFlavorsAsList()

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

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

isDataFlavorSupported

protected boolean isDataFlavorSupported(DataFlavor df)

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