Класс DragGestureEvent

java.lang.Object

java.util.EventObject

java.awt.dnd.DragGestureEvent

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

public class DragGestureEvent extends EventObject

Событие типа DragGestureEvent передаётся методу dragGestureRecognized() класса DragGestureListener, когда определённый DragGestureRecognizer обнаруживает, что на Component, за которым он следит, произошло зависящее от платформы событие начала перетаскивания. Поле action любого объекта DragGestureEvent должно принимать одно из следующих значений:

DnDConstants.ACTION_COPY
DnDConstants.ACTION_MOVE
DnDConstants.ACTION_LINK

Присвоение значения, отличного от указанных выше, может привести к непредсказуемому поведению.

См. также:

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

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

source

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

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

Конструктор	Описание
`DragGestureEvent(DragGestureRecognizer dgr, int act, Point ori, List<? extends InputEvent> evs)`	Создаёт объект `DragGestureEvent`, используя объект `DragGestureRecognizer`, сгенерировавший это событие, параметр `act`, представляющий предпочтительное действие пользователя, параметр `ori`, указывающий на происхождение перетаскивания, и коллекцию `List` событий, составляющих это событие (параметр `evs`).

DragGestureEvent(DragGestureRecognizer dgr,
 int act,
 Point ori,
 List<? extends InputEvent> evs)

Создаёт объект DragGestureEvent, используя объект DragGestureRecognizer, сгенерировавший это событие, параметр act, представляющий предпочтительное действие пользователя, параметр ori, указывающий на происхождение перетаскивания, и коллекцию List событий, составляющих это событие (параметр evs).

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

Модификатор и тип	Метод	Описание
`Component`	`getComponent()`	Возвращает `Component` ассоциированный с этим `DragGestureEvent`.
`int`	`getDragAction()`	Возвращает `int`, представляющий выбранное пользователем действие.
`Point`	`getDragOrigin()`	Возвращает `Point` в координатах `Component`, откуда началось перетаскивание.
`DragSource`	`getDragSource()`	Возвращает `DragSource`.
`DragGestureRecognizer`	`getSourceAsDragGestureRecognizer()`	Возвращает источник как `DragGestureRecognizer`.
`InputEvent`	`getTriggerEvent()`	Возвращает начальное событие, которое вызвало это событие.
`Iterator<InputEvent>`	`iterator()`	Возвращает `Iterator` для событий, составляющих это событие.
`void`	`startDrag(Cursor dragCursor, Transferable transferable)`	Запускает операцию перетаскивания, используя `Cursor` для этой операции перетаскивания и `Transferable`, представляющий исходные данные для этой операции перетаскивания.
`void`	`startDrag(Cursor dragCursor, Transferable transferable, DragSourceListener dsl)`	Запускает перетаскивание, используя начальное `Cursor` для отображения, объект `Transferable`, и `DragSourceListener` для использования.
`void`	`startDrag(Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl)`	Запускает перетаскивание, используя начальное `Cursor` для отображения, `Image` перетаскивания, смещение `Image`, объект `Transferable`, и `DragSourceListener` для использования.
`Object[]`	`toArray()`	Возвращает массив `Object` событий, составляющих событие перетаскивания.
`Object[]`	`toArray(Object[] array)`	Возвращает массив событий, составляющих событие перетаскивания.

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

getSource, toString

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

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

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

DragGestureEvent

public DragGestureEvent(DragGestureRecognizer dgr, int act, Point ori, List<? extends InputEvent> evs)

Создаёт объект DragGestureEvent с помощью экземпляра DragGestureRecognizer , вызывающего это событие, параметром act , представляющим предпочтительное действие пользователя, параметром ori , указывающим на источник перетаскивания, и списком List событий, составляющих жест (параметр evs).

Параметры:

dgr - Экземпляр DragGestureRecognizer , вызывающий это событие

act - Предпочтительное действие пользователя. Сведения о допустимых значениях см. в описании класса DragGestureEvent

ori - Источник перетаскивания

evs - Список List событий, составляющих жест

Исключения:

IllegalArgumentException - если какой-либо параметр равен null

IllegalArgumentException - если параметр act не соответствует значениям, указанным в описании класса DragGestureEvent

См. также:

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

getSourceAsDragGestureRecognizer

public DragGestureRecognizer getSourceAsDragGestureRecognizer()

Возвращает источник как DragGestureRecognizer.

Возвращает:: источник как DragGestureRecognizer

getComponent

public Component getComponent()

Возвращает Component , связанный с этим DragGestureEvent.

Возвращает:: объект Component

getDragSource

public DragSource getDragSource()

Возвращает DragSource.

Возвращает:: объект DragSource

getDragOrigin

public Point getDragOrigin()

Возвращает Point в координатах Component , над которым началось перетаскивание.

Возвращает:: точку Point, в которой началось перетаскивание в координатах компонента.

iterator

public Iterator<InputEvent> iterator()

Возвращает итератор для событий, составляющих жест.

Возвращает:: итератор для событий, составляющих жест

toArray

public Object[] toArray()

Возвращает массив Object событий, составляющих жест перетаскивания.

Возвращает:: массив событий, составляющих жест

toArray

public Object[] toArray(Object[] array)

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

Параметры:: array - массив EventObject подтипов
Возвращает:: массив событий, составляющих жест

getDragAction

public int getDragAction()

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

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

getTriggerEvent

public InputEvent getTriggerEvent()

Возвращает начальное событие, которое инициировало жест.

Возвращает:: первое «триггерное» событие в последовательности жеста

startDrag

public void startDrag(Cursor dragCursor, Transferable transferable) throws InvalidDnDOperationException

Запускает операцию перетаскивания с заданным Cursor для этой операции перетаскивания и Transferable , представляющим исходные данные для этой операции перетаскивания.
Если указан null Cursor , исключение не будет выброшено, и вместо этого будут использованы стандартные курсоры перетаскивания.
Если указан null Transferable , будет выброшено NullPointerException.

Параметры:: dragCursor - начальный Cursor для этой операции перетаскивания или null для обработки стандартного курсора; см. DragSourceContext для получения дополнительных сведений о механизме обработки курсора во время перетаскивания; transferable - Transferable , представляющий исходные данные для этой операции перетаскивания.
Исключения:: InvalidDnDOperationException - если система перетаскивания и опускания не может инициировать операцию перетаскивания или если пользователь пытается начать перетаскивание, в то время как в настоящее время выполняется другая операция перетаскивания.; NullPointerException - если Transferable является null
С момента:: 1.4

startDrag

public void startDrag(Cursor dragCursor, Transferable transferable, DragSourceListener dsl) throws InvalidDnDOperationException

Запускает перетаскивание с заданным начальным Cursor для отображения, объектом Transferable и DragSourceListener для использования.

Параметры:: dragCursor - начальный Cursor для этой операции перетаскивания или null для обработки стандартного курсора; см. DragSourceContext для получения дополнительных сведений о механизме обработки курсора во время перетаскивания; transferable - Transferable источника; dsl - DragSourceListener источника
Исключения:: InvalidDnDOperationException - если система перетаскивания и опускания не может инициировать операцию перетаскивания или если пользователь пытается начать перетаскивание, в то время как в настоящее время выполняется другая операция перетаскивания.

startDrag

public void startDrag(Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl) throws InvalidDnDOperationException

Запустить перетаскивание с заданным начальным Cursor для отображения, изображением перетаскивания Image, смещением Image, объектом Transferable и DragSourceListener для использования.

Параметры:: dragCursor - начальный Cursor для этой операции перетаскивания или null для обработки стандартного курсора; см. DragSourceContext для получения дополнительных сведений о механизме обработки курсора во время перетаскивания; dragImage - dragImage источника; imageOffset - смещение dragImage; transferable - Transferable источника; dsl - DragSourceListener источника
Исключения:: InvalidDnDOperationException - если система перетаскивания и опускания не может инициировать операцию перетаскивания или если пользователь пытается начать перетаскивание, в то время как в настоящее время выполняется другая операция перетаскивания.

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