Spec-Zone.ru › OpenJDK 24

Класс DropTarget

java.lang.Object
java.awt.dnd.DropTarget
Все реализованные интерфейсы:
DropTargetListener, Serializable, EventListener 
public class DropTarget extends Object implements DropTargetListener, Serializable
Объект DropTarget ассоциируется с Component, когда этот Component хочет принимать перетаскивания во время операций Drag и 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).
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 (источник UNICAST).
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, задающим набор допустимых действий по умолчанию, обработчиком событий DropTargetListener, флагом, указывающим, принимает ли 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 и флагом, указывающим, принимает ли 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()
Возвращает набор текущих действий, поддерживаемых этим 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()

Изменение действия опускания

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 не активен.

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

Определяется:
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 не было задано DropTarget, оно связано с по умолчанию FlavorMap.
Возвращает:
FlavorMap для этого DropTarget

setFlavorMap

public void setFlavorMap(FlavorMap fm)
Устанавливает FlavorMap, связанное с этим DropTarget.
Параметры:
fm - новое FlavorMap или null для связывания по умолчанию FlavorMap с этим DropTarget.

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, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/dnd/DropTarget.html

Spec-Zone.ru

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