Класс 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 о том, что он был связан с компонентом. Этот метод обычно вызывается из 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 о том, что он был отсоединен от компонента. Этот метод обычно вызывается из 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 - DropTargetListener для этого 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 - DropTargetListener для этого 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 - DropTargetListener для этого 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 - DropTargetListener для этого 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. Если для этого FlavorMap не было установлено 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 Component для уведомления DropTarget о том, что ComponentPeer связан с этим Component. Вызов этого метода, кроме как для уведомления этого DropTarget о связи ComponentPeer с Component, может привести к неисправности системы DnD.

removeNotify

public void removeNotify()

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

Spec-Zone .ru
спецификации, руководства, описания, API