Spec-Zone.ru › OpenJDK 17

Класс 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, 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)
Вызывает 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()
Уведомляет 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, обрабатывающим события, с 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 активным(in) или неактивным.

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, но может перебрасывать исключения, генерируемые соответствующим методом слушателя.

Specified by:
dragExit в интерфейсе DropTargetListener
Parameters:
dte - DropTargetEvent
See Also:
  • isActive()

drop

public void drop(DropTargetDropEvent dtde)
Вызывает drop у зарегистрированного DropTargetListener и передаёт ему указанный DropTargetDropEvent, если этот DropTarget активен.
Specified by:
drop в интерфейсе DropTargetListener
Parameters:
dtde - DropTargetDropEvent
Throws:
NullPointerException - если dtde равно null и, по крайней мере, одно из следующих условий истинно: этот DropTarget не активен или нет зарегистрированного DropTargetListener.
See Also:
  • isActive()

getFlavorMap

public FlavorMap getFlavorMap()
Получает FlavorMap, связанное с этим DropTarget. Если для этого FlavorMap не было установлено FlavorMap, оно ассоциируется с FlavorMap по умолчанию.
Returns:
FlavorMap для этого DropTarget

setFlavorMap

public void setFlavorMap(FlavorMap fm)
Устанавливает FlavorMap, связанное с этим DropTarget.
Parameters:
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.
Returns:
DropTargetContext связанное с этим DropTarget.

createDropTargetContext

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

createDropTargetAutoScroller

protected DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Component c, Point p)
Создаёт встроенный автоскроллер
Parameters:
c - Component
p - Point
Returns:
Встроенный автоскроллер

initializeAutoscrolling

protected void initializeAutoscrolling(Point p)
Инициализирует автоскроллинг
Parameters:
p - Point

updateAutoscroll

protected void updateAutoscroll(Point dragCursorLocn)
Обновляет автоскроллинг с текущим положением курсора
Parameters:
dragCursorLocn - Point

clearAutoscroll

protected void clearAutoscroll()
Очищает автоскроллинг

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/dnd/DropTarget.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API