Класс DragSourceDragEvent

java.awt.dnd.DragSourceDragEvent

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

public class DragSourceDragEvent extends DragSourceEvent

DragSourceDragEvent передается от DragSourceContextPeer через DragSourceContext объекту DragSourceListener, зарегистрированному в этом DragSourceContext и связанному с ним DragSource.

DragSourceDragEvent сообщает о целевом действии сброса и действии сброса, выбранном пользователем, которые отражают текущее состояние операции перетаскивания.

Целевое действие сброса — одно из DnDConstants, представляющее действие сброса, выбранное текущей целью сброса, если это действие поддерживается источником перетаскивания, либо DnDConstants.ACTION_NONE, если это действие не поддерживается источником перетаскивания.

Действие сброса, выбранное пользователем, зависит от действий сброса, поддерживаемых источником перетаскивания, и действия сброса, выбранного пользователем. Пользователь может выбрать действие сброса, нажимая клавиши-модификаторы во время операции перетаскивания:

  Ctrl + Shift -> ACTION_LINK
  Ctrl         -> ACTION_COPY
  Shift        -> ACTION_MOVE

Если пользователь выбирает действие сброса, действие сброса, выбранное пользователем, — одно из DnDConstants, представляющее выбранное действие сброса, если оно поддерживается источником перетаскивания, либо DnDConstants.ACTION_NONE, если это действие не поддерживается источником перетаскивания.

Если пользователь не выбирает действие сброса, в наборе DnDConstants, представляющем набор действий сброса, поддерживаемых источником перетаскивания, выполняется поиск DnDConstants.ACTION_MOVE, затем DnDConstants.ACTION_COPY, затем DnDConstants.ACTION_LINK, и действием сброса, выбранным пользователем становится первая найденная константа. Если константа не найдена, действием сброса, выбранным пользователем является DnDConstants.ACTION_NONE.

Начиная с:

1.2

См. также:

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

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

source

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

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

Конструктор	Описание
`DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)`	Создает `DragSourceDragEvent`.
`DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)`	Создает `DragSourceDragEvent` с указанными `DragSourceContext`, действием сброса пользователя, целевым действием сброса, модификаторами и координатами.

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

Модификатор и тип	Метод	Описание
`int`	`getDropAction()`	Этот метод возвращает логическое пересечение целевого действия сброса и набора действий сброса, поддерживаемых источником перетаскивания.
`int`	`getGestureModifiers()`	Этот метод возвращает `int`, представляющий текущее состояние модификаторов устройства ввода, связанных с жестом пользователя.
`int`	`getGestureModifiersEx()`	Этот метод возвращает `int`, представляющий текущее состояние расширенных модификаторов устройства ввода, связанных с жестом пользователя.
`int`	`getTargetActions()`	Этот метод возвращает целевое действие сброса.
`int`	`getUserAction()`	Этот метод возвращает действие сброса, выбранное пользователем.

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

getDragSourceContext, getLocation, getX, getY

Модификатор и тип	Метод	Описание
`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()`	Заставляет текущий поток ждать до пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ждать до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ждать до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени.

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

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)

Создает DragSourceDragEvent. Обычно этот класс создает DragSourceContextPeer, а не непосредственно клиентский код. Координаты для этого DragSourceDragEvent не заданы, поэтому getLocation вернет null для этого события.

Аргументы dropAction и action должны быть одним из значений DnDConstants, представляющим одно действие. Аргумент modifiers должен быть либо побитовой маской старых констант java.awt.event.InputEvent.*_MASK, либо побитовой маской расширенных констант java.awt.event.InputEvent.*_DOWN_MASK. Этот конструктор не выбрасывает исключение при недопустимых значениях dropAction, action и modifiers.

Параметры:

dsc — DragSourceContext, который должен управлять уведомлениями об этом событии.

dropAction — действие сброса, выбранное пользователем.

action — целевое действие сброса.

modifiers — клавиши-модификаторы, нажатые во время события (shift, ctrl, alt, meta). Следует использовать либо расширенные модификаторы _DOWN_MASK, либо старые модификаторы _MASK; обе модели не должны смешиваться в одном событии. Предпочтительно использовать расширенные модификаторы.

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

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

См. также:

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)

Создает DragSourceDragEvent с указанными DragSourceContext, действием сброса пользователя, целевым действием сброса, модификаторами и координатами.

Параметры:

dsc — DragSourceContext, связанный с этим событием.

dropAction — действие сброса, выбранное пользователем.

action — целевое действие сброса.

x — горизонтальная координата положения курсора

y — вертикальная координата положения курсора

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

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

Начиная с:

1.4

См. также:

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

getTargetActions

public int getTargetActions()

Этот метод возвращает целевое действие сброса.

Возвращает:: целевое действие сброса.

getGestureModifiers

public int getGestureModifiers()

Этот метод возвращает int, представляющий текущее состояние модификаторов устройства ввода, связанных с жестом пользователя. Обычно это кнопки мыши или клавиши-модификаторы клавиатуры.

Если переданные конструктору modifiers недопустимы, этот метод возвращает их без изменений.

Возвращает:: текущее состояние модификаторов устройства ввода

getGestureModifiersEx

public int getGestureModifiersEx()

Этот метод возвращает int, представляющий текущее состояние расширенных модификаторов устройства ввода, связанных с жестом пользователя. См. InputEvent.getModifiersEx()

Если переданные конструктору modifiers недопустимы, этот метод возвращает их без изменений.

Возвращает:: текущее состояние расширенных модификаторов устройства ввода
Начиная с:: 1.4

getUserAction

public int getUserAction()

Этот метод возвращает действие сброса, выбранное пользователем.

Возвращает:: действие сброса, выбранное пользователем.

getDropAction

public int getDropAction()

Этот метод возвращает логическое пересечение целевого действия сброса и набора действий сброса, поддерживаемых источником перетаскивания.

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

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