Класс DragGestureEvent

Все реализованные интерфейсы:
Serializable
public class DragGestureEvent
extends EventObject

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

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

См. также:
DragGestureRecognizer, DragGestureListener, DragSource, DnDConstants, Сериализованная форма

Поля

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

source

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

Конструктор Описание
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 - Список событий, составляющих жест
Исключения:
IllegalArgumentException - если какой-либо параметр равен null
IllegalArgumentException - если параметр act не соответствует значениям, указанным в описании класса DragGestureEvent
См. также:
DnDConstants

Методы

getSourceAsDragGestureRecognizer

public DragGestureRecognizer getSourceAsDragGestureRecognizer()

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

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

getComponent

public Component getComponent()

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

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

getDragSource

public DragSource getDragSource()

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

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

getDragOrigin

public Point getDragOrigin()

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

Возвращает:
точку, из которой началось перетаскивание, в координатах объекта 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 - 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, 2020, 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/11/docs/api/java.desktop/java/awt/dnd/DragGestureEvent.html

Spec-Zone .ru
спецификации, руководства, описания, API