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

Модификатор и тип	Поле	Описание
`protected Object`	`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`	`getSource()`	Объект, на котором изначально произошло событие.
`String`	`toString()`	Возвращает строковое представление этого EventObject.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ждать, пока он не будет разбужен, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ждать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданный интервал реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ждать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданный интервал реального времени.

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

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.

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

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.