Класс DropTarget

java.lang.Object

java.awt.dnd.DropTarget

Все реализуемые интерфейсы:: DropTargetListener, Serializable, EventListener

public class DropTarget extends Object implements DropTargetListener, Serializable

DropTarget связывается с Component, когда этот Component должен принимать объекты при операциях перетаскивания.

Каждый DropTarget связывается с FlavorMap. Далее под FlavorMap подразумевается FlavorMap, возвращаемый методом SystemFlavorMap.getDefaultFlavorMap().

С версии:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected static class`	`DropTarget.DropTargetAutoScroller`	этот защищённый вложенный класс реализует автоматическую прокрутку

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

Конструктор	Описание
`DropTarget()`	Создаёт `DropTarget`.
`DropTarget(Component c, int ops, DropTargetListener dtl)`	Создаёт `DropTarget`, принимающий `Component`, с которым он связывается, `int`, задающий поддерживаемые действия, допустимые по умолчанию, и `DropTargetListener` для обработки событий.
`DropTarget(Component c, int ops, DropTargetListener dtl, boolean act)`	Создаёт `DropTarget`, принимающий `Component`, с которым он связывается, `int`, задающий поддерживаемые действия, допустимые по умолчанию, `DropTargetListener` для обработки событий и `boolean`, указывающий, принимает ли `DropTarget` в данный момент перетаскиваемые объекты.
`DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm)`	Создаёт новый DropTarget, принимающий `Component`, с которым он связывается, `int`, задающий поддерживаемые действия, допустимые по умолчанию, `DropTargetListener` для обработки событий, `boolean`, указывающий, принимает ли `DropTarget` в данный момент перетаскиваемые объекты, и `FlavorMap` для использования (или null для `FlavorMap` по умолчанию).
`DropTarget(Component c, DropTargetListener dtl)`	Создаёт `DropTarget`, принимающий `Component`, с которым он связывается, и `DropTargetListener` для обработки событий.

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

Модификатор и тип	Метод	Описание
`void`	`addDropTargetListener(DropTargetListener dtl)`	Добавляет новый `DropTargetListener` (источник UNICAST).
`void`	`addNotify()`	Уведомляет DropTarget о том, что он связан с Component. Этот метод обычно вызывается из java.awt.Component.addNotify() компонента Component, связанного с этим DropTarget, чтобы уведомить DropTarget о том, что с этим компонентом связан ComponentPeer.
`protected void`	`clearAutoscroll()`	отключает автоматическую прокрутку
`protected DropTarget.DropTargetAutoScroller`	`createDropTargetAutoScroller(Component c, Point p)`	создаёт встроенный механизм автоматической прокрутки
`protected DropTargetContext`	`createDropTargetContext()`	Создаёт DropTargetContext, связанный с этим DropTarget.
`void`	`dragEnter(DropTargetDragEvent dtde)`	Вызывает `dragEnter` у зарегистрированного `DropTargetListener` и передаёт ему указанный `DropTargetDragEvent`.
`void`	`dragExit(DropTargetEvent dte)`	Вызывает `dragExit` у зарегистрированного `DropTargetListener` и передаёт ему указанный `DropTargetEvent`.
`void`	`dragOver(DropTargetDragEvent dtde)`	Вызывает `dragOver` у зарегистрированного `DropTargetListener` и передаёт ему указанный `DropTargetDragEvent`.
`void`	`drop(DropTargetDropEvent dtde)`	Если этот `DropTarget` активен, вызывает `drop` у зарегистрированного `DropTargetListener` и передаёт ему указанный `DropTargetDropEvent`.
`void`	`dropActionChanged(DropTargetDragEvent dtde)`	Вызывает `dropActionChanged` у зарегистрированного `DropTargetListener` и передаёт ему указанный `DropTargetDragEvent`.
`Component`	`getComponent()`	Возвращает `Component`, связанный с этим `DropTarget`.
`int`	`getDefaultActions()`	Возвращает `int`, представляющий текущие действия, поддерживаемые этим `DropTarget`.
`DropTargetContext`	`getDropTargetContext()`	Возвращает `DropTargetContext`, связанный с этим `DropTarget`.
`FlavorMap`	`getFlavorMap()`	Возвращает `FlavorMap`, связанный с этим `DropTarget`.
`protected void`	`initializeAutoscrolling(Point p)`	инициализирует автоматическую прокрутку
`boolean`	`isActive()`	Сообщает, активен ли в данный момент этот `DropTarget` (готов ли он принимать перетаскиваемые объекты).
`void`	`removeDropTargetListener(DropTargetListener dtl)`	Удаляет текущий `DropTargetListener` (источник UNICAST).
`void`	`removeNotify()`	Уведомляет DropTarget о том, что он больше не связан с Component. Этот метод обычно вызывается из java.awt.Component.removeNotify() компонента Component, связанного с этим DropTarget, чтобы уведомить DropTarget о том, что связь ComponentPeer с этим компонентом разорвана.
`void`	`setActive(boolean isActive)`	Делает DropTarget активным, если `true`, и неактивным, если `false`.
`void`	`setComponent(Component c)`	Примечание: этот интерфейс необходим для безопасной привязки DropTarget к Component одним из двух способов: `component.setDropTarget(droptarget);` или `droptarget.setComponent(component);`
`void`	`setDefaultActions(int ops)`	Задаёт действия, допустимые по умолчанию для этого `DropTarget`
`void`	`setFlavorMap(FlavorMap fm)`	Задаёт `FlavorMap`, связанный с этим `DropTarget`.
`protected void`	`updateAutoscroll(Point dragCursorLocn)`	обновляет автоматическую прокрутку в соответствии с текущим положением курсора

Методы, объявленные в классе 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()`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения указанного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения указанного промежутка реального времени.

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

DropTarget

public DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm) throws HeadlessException

Создаёт новый DropTarget, принимающий Component, с которым он связывается, int, задающий поддерживаемые действия, допустимые по умолчанию, DropTargetListener для обработки событий, boolean, указывающий, принимает ли DropTarget в данный момент перетаскиваемые объекты, и FlavorMap для использования (или null для FlavorMap по умолчанию).

Компонент будет принимать перетаскиваемые объекты, только если он включён.

Параметры:

c — Component, с которым связан этот DropTarget

ops — Действия, допустимые по умолчанию для этого DropTarget

dtl — DropTargetListener для этого DropTarget

act — Принимает ли DropTarget перетаскиваемые объекты.

fm — FlavorMap для использования или null для FlavorMap по умолчанию

Вызывает исключение:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true

См. также:

DropTarget

public DropTarget(Component c, int ops, DropTargetListener dtl, boolean act) throws HeadlessException

Создаёт DropTarget, принимающий Component, с которым он связывается, int, задающий поддерживаемые действия, допустимые по умолчанию, DropTargetListener для обработки событий и boolean, указывающий, принимает ли DropTarget в данный момент перетаскиваемые объекты.

Компонент будет принимать перетаскиваемые объекты, только если он включён.

Параметры:

c — Component, с которым связан этот DropTarget

ops — Действия, допустимые по умолчанию для этого DropTarget

dtl — DropTargetListener для этого DropTarget

act — Принимает ли DropTarget перетаскиваемые объекты.

Вызывает исключение:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true

См. также:

DropTarget

public DropTarget() throws HeadlessException

Создаёт DropTarget.

Вызывает исключение:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true

См. также:

DropTarget

public DropTarget(Component c, DropTargetListener dtl) throws HeadlessException

Создаёт DropTarget, принимающий Component, с которым он связывается, и DropTargetListener для обработки событий.

Компонент будет принимать перетаскиваемые объекты, только если он включён.

Параметры:

c — Component, с которым связан этот DropTarget

dtl — DropTargetListener для этого DropTarget

Вызывает исключение:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true

См. также:

DropTarget

public DropTarget(Component c, int ops, DropTargetListener dtl) throws HeadlessException

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

Компонент будет принимать перетаскиваемые объекты, только если он включён.

Параметры:

c — Component, с которым связан этот DropTarget

ops — Действия, допустимые по умолчанию для этого DropTarget

dtl — DropTargetListener для этого DropTarget

Вызывает исключение:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true

См. также:

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

setComponent

public void setComponent(Component c)

Примечание: этот интерфейс необходим для безопасной привязки DropTarget к Component одним из двух способов: component.setDropTarget(droptarget); или droptarget.setComponent(component);

Компонент будет принимать перетаскиваемые объекты, только если он включён.

Параметры:: c — новый Component, с которым должен быть связан этот DropTarget.

getComponent

public Component getComponent()

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

Возвращает:: текущий Component

setDefaultActions

public void setDefaultActions(int ops)

Задаёт действия, допустимые по умолчанию для этого DropTarget

Параметры:

ops — действия по умолчанию

См. также:

getDefaultActions

public int getDefaultActions()

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

Возвращает:: текущие действия по умолчанию

setActive

public void setActive(boolean isActive)

Делает DropTarget активным, если true, и неактивным, если false.

Параметры:: isActive — задаёт (не)активное состояние DropTarget.

isActive

public boolean isActive()

Сообщает, активен ли в данный момент этот DropTarget (готов ли он принимать перетаскиваемые объекты).

Возвращает:: true, если активен, false, если нет

addDropTargetListener

public void addDropTargetListener(DropTargetListener dtl) throws TooManyListenersException

Добавляет новый DropTargetListener (источник UNICAST).

Параметры:: dtl — новый DropTargetListener
Вызывает исключение:: TooManyListenersException — если DropTargetListener уже добавлен к этому DropTarget.

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener dtl)

Удаляет текущий DropTargetListener (источник UNICAST).

Параметры:: dtl — DropTargetListener, который нужно отменить.

dragEnter

public void dragEnter(DropTargetDragEvent dtde)

Вызывает dragEnter у зарегистрированного DropTargetListener и передаёт ему указанный DropTargetDragEvent. Ничего не делает, если этот DropTarget не активен.

Определено в:

dragEnter в интерфейсе DropTargetListener

Параметры:

dtde — DropTargetDragEvent

Вызывает исключение:

NullPointerException — если этот DropTarget активен и dtde равен null

См. также:

dragOver

public void dragOver(DropTargetDragEvent dtde)

Вызывает dragOver у зарегистрированного DropTargetListener и передаёт ему указанный DropTargetDragEvent. Ничего не делает, если этот DropTarget не активен.

Определено в:

dragOver в интерфейсе DropTargetListener

Параметры:

dtde — DropTargetDragEvent

Вызывает исключение:

NullPointerException — если этот DropTarget активен и dtde равен null

См. также:

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

Вызывает dropActionChanged у зарегистрированного DropTargetListener и передаёт ему указанный DropTargetDragEvent. Ничего не делает, если этот DropTarget не активен.

Определено в:

dropActionChanged в интерфейсе DropTargetListener

Параметры:

dtde — DropTargetDragEvent

Вызывает исключение:

NullPointerException — если этот DropTarget активен и dtde равен null

См. также:

dragExit

public void dragExit(DropTargetEvent dte)

Вызывает dragExit у зарегистрированного DropTargetListener и передаёт ему указанный DropTargetEvent. Ничего не делает, если этот DropTarget не активен.

Сам этот метод не вызывает исключение для нулевого параметра, однако исключения могут быть вызваны соответствующим методом прослушивателя.

Определено в:

dragExit в интерфейсе DropTargetListener

Параметры:

dte — DropTargetEvent

См. также:

drop

public void drop(DropTargetDropEvent dtde)

Если этот DropTarget активен, вызывает drop у зарегистрированного DropTargetListener и передаёт ему указанный DropTargetDropEvent.

Определено в:

drop в интерфейсе DropTargetListener

Параметры:

dtde — DropTargetDropEvent

Вызывает исключение:

NullPointerException — если dtde равно null и выполняется хотя бы одно из следующих условий: этот DropTarget не активен или не зарегистрирован DropTargetListener.

См. также:

getFlavorMap

public FlavorMap getFlavorMap()

Возвращает FlavorMap, связанный с этим DropTarget. Если для этого DropTarget не задан FlavorMap, используется FlavorMap по умолчанию.

Возвращает:: FlavorMap для этого DropTarget

setFlavorMap

public void setFlavorMap(FlavorMap fm)

Задаёт FlavorMap, связанный с этим DropTarget.

Параметры:: fm — новый FlavorMap или null, чтобы связать с этим DropTarget FlavorMap по умолчанию.

addNotify

public void addNotify()

Уведомляет DropTarget о том, что он связан с Component. Этот метод обычно вызывается из java.awt.Component.addNotify() компонента Component, связанного с этим DropTarget, чтобы уведомить DropTarget о том, что с этим компонентом связан ComponentPeer. Вызов этого метода с любой другой целью, кроме уведомления DropTarget о связывании ComponentPeer с Component, может привести к сбою системы DnD.

removeNotify

public void removeNotify()

Уведомляет DropTarget о том, что связь с Component разорвана. Этот метод обычно вызывается из java.awt.Component.removeNotify() компонента Component, связанного с этим DropTarget, чтобы уведомить DropTarget о том, что связь ComponentPeer с этим компонентом разорвана. Вызов этого метода с любой другой целью, кроме уведомления DropTarget о разрыве связи ComponentPeer с Component, может привести к сбою системы DnD.

getDropTargetContext

public DropTargetContext getDropTargetContext()

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

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

createDropTargetContext

protected DropTargetContext createDropTargetContext()

Создаёт DropTargetContext, связанный с этим DropTarget. Подклассы могут переопределить этот метод, чтобы создать собственный подкласс DropTargetContext. Этот метод обычно вызывается *только* компонентом DropTargetContextPeer платформы, когда операция перетаскивания достигает этого DropTarget. Обращение к контексту при отсутствии текущего перетаскивания приводит к неопределённым результатам.

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

createDropTargetAutoScroller

protected DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Component c, Point p)

создаёт встроенный механизм автоматической прокрутки

Параметры:: c — Component; p — Point
Возвращает:: встроенный механизм автоматической прокрутки

initializeAutoscrolling

protected void initializeAutoscrolling(Point p)

инициализирует автоматическую прокрутку

Параметры:: p — Point

updateAutoscroll

protected void updateAutoscroll(Point dragCursorLocn)

обновляет автоматическую прокрутку в соответствии с текущим положением курсора

Параметры:: dragCursorLocn — Point

clearAutoscroll

protected void clearAutoscroll()

отключает автоматическую прокрутку

© 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.