Класс 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`, указывающий происхождение перетаскивания, и последовательность событий, составляющих жестикуляцию (параметр `evs`).

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

Создаёт объект DragGestureEvent, используя экземпляр DragGestureRecognizer, который генерирует это событие, параметр act, представляющий предпочтительное действие пользователя, параметр ori, указывающий происхождение перетаскивания, и последовательность событий, составляющих жестикуляцию (параметр 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.

Возвращает:: компонент

getDragSource

public DragSource getDragSource()

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

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

getDragOrigin

public Point getDragOrigin()

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

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

iterator

public Iterator<InputEvent> 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 - Передаваемый объект источника; dsl - Слушатель DragSource источника
Исключения:: 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 - Изображение перетаскивания источника; imageOffset - Смещение изображения перетаскивания; transferable - Передаваемый объект источника; dsl - Слушатель DragSource источника
Исключения:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/dnd/DragGestureEvent.html