Класс 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 SOURCE).
`void`	`addNotify()`	Уведомляет DropTarget о том, что он связан с компонентом. Этот метод обычно вызывается из java.awt.Component.addNotify() соответствующего компонента для уведомления 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)`	Возвращает `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 SOURCE).
`void`	`removeNotify()`	Уведомляет DropTarget о том, что он разъединен с компонентом. Этот метод обычно вызывается из java.awt.Component.removeNotify() соответствующего компонента для уведомления DropTarget о том, что ComponentPeer разъединен с этим компонентом.
`void`	`setActive(boolean isActive)`	Устанавливает DropTarget активным, если `true`, неактивным, если `false`.
`void`	`setComponent(Component c)`	Примечание: этот интерфейс необходим для безопасной ассоциации DropTarget с компонентом одним из двух способов: `component.setDropTarget(droptarget);` или `droptarget.setComponent(component);`
`void`	`setDefaultActions(int ops)`	Устанавливает стандартные допустимые действия для этого `DropTarget`
`void`	`setFlavorMap(FlavorMap fm)`	Устанавливает `FlavorMap`, связанное с этим `DropTarget`.
`protected void`	`updateAutoscroll(Point dragCursorLocn)`	Обновляет автоматическое прокручивание с текущим положением курсора

Методы, объявленные в классе java.lang.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, флагом, указывающим, принимает ли DropTarget в настоящий момент перетаскивания, и FlavorMap, используемым (или null для значения по умолчанию FlavorMap).

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

Parameters:

c - Component , с которым связан данный DropTarget

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

dtl - Обработчик событий для данного DropTarget

act - Принимает ли DropTarget перетаскивания.

fm - Используемый FlavorMap, или null для значения по умолчанию FlavorMap

Throws:

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

See Also:

DropTarget

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

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

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

Parameters:

c - Component , с которым связан данный DropTarget

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

dtl - Обработчик событий для данного DropTarget

act - Принимает ли DropTarget перетаскивания.

Throws:

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

See Also:

DropTarget

public DropTarget() throws HeadlessException

Создает DropTarget

Throws:

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

See Also:

DropTarget

public DropTarget(Component c, DropTargetListener dtl) throws HeadlessException

Создает DropTarget на основе Component, и обработчика событий DropTargetListener.

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

Parameters:

c - Component , с которым связан данный DropTarget

dtl - Обработчик событий для данного DropTarget

Throws:

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

See Also:

DropTarget

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

Создает DropTarget на основе Component, допустимых действий int, и обработчика событий DropTargetListener.

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

Parameters:

c - Component , с которым связан данный DropTarget

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

dtl - Обработчик событий для данного DropTarget

Throws:

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

See Also:

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

setComponent

public void setComponent(Component c)

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

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

Parameters:: c - Новый Component , с которым должен быть связан данный DropTarget

getComponent

public Component getComponent()

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

Returns:: текущий Component

setDefaultActions

public void setDefaultActions(int ops)

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

Parameters:

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

See Also:

getDefaultActions

public int getDefaultActions()

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

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

setActive

public void setActive(boolean isActive)

Устанавливает активность DropTarget, если true, и делает неактивным, если false.

Parameters:: isActive - Устанавливает DropTarget (активный/неактивный).

isActive

public boolean isActive()

Указывает, является ли данный DropTarget активным (готов к приему перетаскиваний).

Returns:: true если активен, false если нет

addDropTargetListener

public void addDropTargetListener(DropTargetListener dtl) throws TooManyListenersException

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

Parameters:: dtl - Новый DropTargetListener
Throws:: TooManyListenersException - если DropTargetListener уже добавлен к данному DropTarget.

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener dtl)

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

Parameters:: dtl - DropTargetListener для удаления.

dragEnter

public void dragEnter(DropTargetDragEvent dtde)

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

Specified by:

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

Parameters:

dtde - DropTargetDragEvent

Throws:

NullPointerException - если этот DropTarget активен и dtde является null

See Also:

dragOver

public void dragOver(DropTargetDragEvent dtde)

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

Specified by:

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

Parameters:

dtde - DropTargetDragEvent

Throws:

NullPointerException - если этот DropTarget активен и dtde является null

See Also:

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

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

Specified by:

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

Parameters:

dtde - DropTargetDragEvent

Throws:

NullPointerException - если этот DropTarget активен и dtde является null

See Also:

dragExit

public void dragExit(DropTargetEvent dte)

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

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

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

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

Параметры:

dte - DropTargetEvent

См. также:

drop

public void drop(DropTargetDropEvent dtde)

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

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

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

removeNotify

public void removeNotify()

Уведомляет DropTarget о том, что он больше не связан с компонентом. Этот метод обычно вызывается из java.awt.Component.removeNotify() компонента, связанного с этим DropTarget, чтобы уведомить DropTarget о том, что с этим компонентом больше не связан ComponentPeer. Вызов этого метода, кроме как для уведомления этого DropTarget об отсоединении ComponentPeer от компонента, может привести к сбоям в системе 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, 2023, 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/21/docs/api/java.desktop/java/awt/dnd/DropTarget.html