Класс DragSourceEvent

java.lang.Object

java.util.EventObject

java.awt.dnd.DragSourceEvent

Все реализуемые интерфейсы:: Serializable

Прямые известные подклассы:: DragSourceDragEvent, DragSourceDropEvent

public class DragSourceEvent extends EventObject

Этот класс является базовым классом для DragSourceDragEvent и DragSourceDropEvent.

DragSourceEvents создаются при каждом входе перетаскиваемого объекта в область сброса, перемещении над ней или выходе из неё, при изменении действия сброса, а также при завершении перетаскивания. Местоположение, указанное в созданном DragSourceEvent, соответствует положению указателя мыши в экранных координатах в момент возникновения этого события.

В многомониторной среде без виртуального устройства местоположение указателя задаётся в системе координат инициатора GraphicsConfiguration. Инициатор GraphicsConfiguration — это GraphicsConfiguration Component, на котором было распознано жестовое действие перетаскивания для текущей операции перетаскивания. Если местоположение указателя находится за пределами инициатора GraphicsConfiguration, сообщаемые координаты ограничиваются границами этого GraphicsConfiguration.

В многомониторной среде с виртуальным устройством местоположение задаётся в соответствующей виртуальной системе координат. Если местоположение указателя находится за пределами виртуального устройства, сообщаемые координаты ограничиваются границами виртуального устройства.

Начиная с:

1.2

См. также:

Краткое описание полей

Поля, объявленные в классе EventObject

source

Модификатор и тип	Поле	Описание
`protected Object`	`source`	Объект, в котором первоначально произошло событие.

Краткое описание конструкторов

Конструктор	Описание
`DragSourceEvent(DragSourceContext dsc)`	Создаёт `DragSourceEvent` для указанного `DragSourceContext`.
`DragSourceEvent(DragSourceContext dsc, int x, int y)`	Создаёт `DragSourceEvent` для указанного `DragSourceContext` и координат местоположения указателя.

Краткое описание методов

Модификатор и тип	Метод	Описание
`DragSourceContext`	`getDragSourceContext()`	Этот метод возвращает `DragSourceContext`, породивший событие.
`Point`	`getLocation()`	Этот метод возвращает `Point`, указывающий местоположение указателя в экранных координатах в момент возникновения этого события, или `null`, если местоположение указателя для этого события не указано.
`int`	`getX()`	Этот метод возвращает горизонтальную координату местоположения указателя в экранных координатах в момент возникновения этого события или ноль, если местоположение указателя для этого события не указано.
`int`	`getY()`	Этот метод возвращает вертикальную координату местоположения указателя в экранных координатах в момент возникновения этого события или ноль, если местоположение указателя для этого события не указано.

Методы, объявленные в классе EventObject

getSource, toString

Модификатор и тип	Метод	Описание
`Object`	`getSource()`	Объект, в котором первоначально произошло событие.
`String`	`toString()`	Возвращает строковое представление этого EventObject.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, предназначено для удаления: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

DragSourceEvent

public DragSourceEvent(DragSourceContext dsc)

Создаёт DragSourceEvent для указанного DragSourceContext. Координаты для этого DragSourceEvent не заданы, поэтому getLocation вернёт null для этого события.

Параметры:

dsc — DragSourceContext

Выбрасывает:

IllegalArgumentException — если dsc равно null.

См. также:

DragSourceEvent

public DragSourceEvent(DragSourceContext dsc, int x, int y)

Создаёт DragSourceEvent для указанного DragSourceContext и координат местоположения указателя.

Параметры:: dsc — DragSourceContext; x — горизонтальная координата местоположения указателя; y — вертикальная координата местоположения указателя
Выбрасывает:: IllegalArgumentException — если dsc равно null.
Начиная с:: 1.4

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

getDragSourceContext

public DragSourceContext getDragSourceContext()

Этот метод возвращает DragSourceContext, породивший событие.

Возвращает:: DragSourceContext, породивший событие

getLocation

public Point getLocation()

Этот метод возвращает Point, указывающий местоположение указателя в экранных координатах в момент возникновения этого события, или null, если местоположение указателя для этого события не указано.

Возвращает:: Point, указывающий местоположение указателя, или null, если местоположение указателя не указано
Начиная с:: 1.4

getX

public int getX()

Этот метод возвращает горизонтальную координату местоположения указателя в экранных координатах в момент возникновения этого события или ноль, если местоположение указателя для этого события не указано.

Возвращает:: целое число, указывающее горизонтальную координату местоположения указателя, или ноль, если местоположение указателя не указано
Начиная с:: 1.4

getY

public int getY()

Этот метод возвращает вертикальную координату местоположения указателя в экранных координатах в момент возникновения этого события или ноль, если местоположение указателя для этого события не указано.

Возвращает:: целое число, указывающее вертикальную координату местоположения указателя, или ноль, если местоположение указателя не указано
Начиная с:: 1.4

© 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.