Класс DragSourceDragEvent

java.lang.Object
- java.util.EventObject
- - java.awt.dnd.DragSourceEvent
  - - 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
См. также:: Сериализованная форма

Поля

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

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()`	Этот метод возвращает действие отпускания пользователя.

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

getDragSourceContext, getLocation, getX, getY

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

getSource, toString

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

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

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

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.
См. также:: InputEvent, DragSourceEvent.getLocation()

DragSourceDragEvent

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

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

Аргументы 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 модификаторы, но обе модели не должны смешиваться в одном событии. Предпочтительнее использовать расширенные модификаторы.; x - горизонтальная координата расположения курсора; y - вертикальная координата расположения курсора
Исключения:: IllegalArgumentException - если dsc равен null.
С тех пор:: 1.4
См. также:: InputEvent

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

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()

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

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