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

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

См. также:

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

Поля, объявленные в классе 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)`	Возвращает массив событий, составляющих жест перетаскивания.

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

getSource, toString

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

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

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

DragGestureEvent

public DragGestureEvent(DragGestureRecognizer dgr, int act, Point ori, List<? extends InputEvent> 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, над которым началось перетаскивание.

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

iterator

public Iterator<InputEvent> iterator()

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

Возвращает:: 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, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/dnd/DragGestureEvent.html