Класс DragSourceDragEvent

java.awt.dnd.DragSourceDragEvent

Все реализованные интерфейсы:: Serializable

public class DragSourceDragEvent extends DragSourceEvent

Событие DragSourceDragEvent доставляется от источника перетаскивания через менеджер перетаскивания к объекту, зарегистрированному с этим источником перетаскивания и его ассоциированными данными.

Событие 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.

Since:

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. Этот класс обычно создаётся менеджером перетаскивания, а не непосредственно кодом клиента. Координаты для этого 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.

Since:

1.4

См. также:

InputEvent

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

getTargetActions

public int getTargetActions()

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

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

getGestureModifiers

public int getGestureModifiers()

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

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

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

getGestureModifiersEx

public int getGestureModifiersEx()

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

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

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

getUserAction

public int getUserAction()

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

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

getDropAction

public int getDropAction()

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

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

© 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/DragSourceDragEvent.html