Класс 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

См. также:

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

Поля, объявленные в классе 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.

См. также:

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, 2023, 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/21/docs/api/java.desktop/java/awt/dnd/DragSourceDragEvent.html