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

См. также:

DnDConstants

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

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 - 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 - Изображение перетаскивания источника; imageOffset - Смещение изображения перетаскивания; transferable - Передаваемый объект источника; dsl - DragSourceListener источника
Исключения:: InvalidDnDOperationException - если система перетаскивания и сбрасывания не может инициировать операцию перетаскивания или если пользователь пытается начать перетаскивание, пока выполняется другая операция перетаскивания.

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/dnd/DragGestureEvent.html