Класс 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` (ОДНОАДРЕСНЫЙ ИСТОЧНИК).
`void`	`addNotify()`	Уведомляет DropTarget о том, что он связан с Component. Этот метод обычно вызывается методом java.awt.Component.addNotify() компонента, связанного с этим 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)`	Вызывает `drop` зарегистрированного `DropTargetListener` и передаёт ему указанный `DropTargetDropEvent`, если этот `DropTarget` активен.
`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` (ОДНОАДРЕСНЫЙ ИСТОЧНИК).
`void`	`removeNotify()`	Уведомляет DropTarget о том, что он отсоединён от Component. Этот метод обычно вызывается методом java.awt.Component.removeNotify() компонента, связанного с этим 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

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

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 (ОДНОАДРЕСНЫЙ ИСТОЧНИК).

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

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener dtl)

Удаляет текущий DropTargetListener (ОДНОАДРЕСНЫЙ ИСТОЧНИК).

Параметры:: 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 не активен.

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

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

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() компонента, связанного с этим DropTarget, чтобы уведомить DropTarget о связывании ComponentPeer с этим компонентом. Вызов этого метода с любой другой целью, кроме уведомления DropTarget о связывании ComponentPeer с Component, может привести к сбою системы DnD.

removeNotify

public void removeNotify()

Уведомляет DropTarget о том, что он отсоединён от Component. Этот метод обычно вызывается методом java.awt.Component.removeNotify() компонента, связанного с этим 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/dnd/DropTarget.html