Класс DropTarget

java.lang.Object
- java.awt.dnd.DropTarget

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

public class DropTarget
extends Object
implements DropTargetListener, Serializable

Объект DropTarget ассоциирован с Component, когда этот Component хочет принять перетаскивание во время операций Drag and Drop.

Каждый DropTarget связан с FlavorMap. По умолчанию FlavorMap обозначает FlavorMap, возвращаемое SystemFlavorMap.getDefaultFlavorMap().

С тех пор:: 1.2
См. также:: Сериализованная форма

Вложенные классы

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

Конструкторы

Конструктор и описание
`DropTarget()` Создаёт `DropTarget`.
`DropTarget(Component c, DropTargetListener dtl)` Создаёт `DropTarget` с учётом `Component`, с которым он должен быть связан, и `DropTargetListener` для обработки событий.
`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`).

Методы

Модификатор и тип	Метод и описание
`void`	`addDropTargetListener(DropTargetListener dtl)` Добавляет новый `DropTargetListener` (UNICAST SOURCE).
`void`	`addNotify(java.awt.peer.ComponentPeer peer)` Уведомляет DropTarget о том, что он был связан с компонентом. Этот метод обычно вызывается из 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` (UNICAST SOURCE).
`void`	`removeNotify(java.awt.peer.ComponentPeer peer)` Уведомляет DropTarget о том, что он был отсоединён от компонента. Этот метод обычно вызывается из java.awt.Component.removeNotify() компонента, связанного с этим DropTarget, чтобы уведомить 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, boolean, указывающим, принимает ли DropTarget в данный момент элементы, и FlavorMap, который нужно использовать (или null для значения по умолчанию FlavorMap).

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

Параметры:: c - Component, с которым связан этот DropTarget; ops - По умолчанию допустимые действия для этого DropTarget; dtl - Обработчик событий для этого DropTarget; act - Принимает ли DropTarget элементы.; fm - FlavorMap для использования, или null для значения по умолчанию FlavorMap
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:: GraphicsEnvironment.isHeadless()

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 - Обработчик событий для этого DropTarget; act - Принимает ли DropTarget элементы.
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:: GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget()
           throws HeadlessException

Создаёт DropTarget.

Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:: GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component c,
                  DropTargetListener dtl)
           throws HeadlessException

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

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

Параметры:: c - Component, с которым связан этот DropTarget; dtl - Обработчик событий для этого DropTarget
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:: GraphicsEnvironment.isHeadless()

DropTarget

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

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

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

Параметры:: c - Component, с которым связан этот DropTarget; ops - По умолчанию допустимые действия для этого DropTarget; dtl - Обработчик событий для этого DropTarget
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:: GraphicsEnvironment.isHeadless()

Методы

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 - Действия по умолчанию
См. также:: DnDConstants

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 - если DropTargetListener уже добавлен в этот DropTarget.

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
См. также:: isActive()

dragOver

public void dragOver(DropTargetDragEvent dtde)

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

Определено в:: dragOver в интерфейсе DropTargetListener
Параметры:: dtde - DropTargetDragEvent
Исключения:: NullPointerException - если этот DropTarget активен и dtde равен null
См. также:: isActive()

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

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

Определено в:: dropActionChanged в интерфейсе DropTargetListener
Параметры:: dtde - DropTargetDragEvent
Исключения:: NullPointerException - если этот DropTarget активен и dtde равен null
См. также:: isActive()

dragExit

public void dragExit(DropTargetEvent dte)

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

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

Определено в:: dragExit в интерфейсе DropTargetListener
Параметры:: dte - DropTargetEvent
См. также:: isActive()

drop

public void drop(DropTargetDropEvent dtde)

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

Определено в:: drop в интерфейсе DropTargetListener
Параметры:: dtde - DropTargetDropEvent
Исключения:: NullPointerException - если dtde равно null и хотя бы одно из следующих условий выполняется: этот DropTarget не активен, или DropTargetListener не зарегистрирован.
См. также:: isActive()

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(java.awt.peer.ComponentPeer peer)

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

Параметры:: peer - Peer компонента, с которым мы связаны!

removeNotify

public void removeNotify(java.awt.peer.ComponentPeer peer)

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

Параметры:: peer - Peer компонента, от которого мы отсоединяемся!

getDropTargetContext

public DropTargetContext getDropTargetContext()

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

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

createDropTargetContext

protected DropTargetContext createDropTargetContext()

Создаёт DropTargetContext, связанное с этим DropTarget. Подклассы могут переопределять этот метод для создания собственного подкласса DropTargetContext. Этот вызов обычно *только* вызывается DropTargetContextPeer платформы, когда операция перетаскивания сталкивается с этим 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, 2020, 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.