Класс 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
- См. также:
-
DragGestureRecognizer,DragGestureListener,DragSource,DnDConstants, Сериализованная форма
Поля
Поля, унаследованные от класса java.util.EventObject
source Конструкторы
| Конструктор и описание |
|---|
DragGestureEvent(DragGestureRecognizer dgr,
int act,
Point ori,
List<? extends InputEvent> evs) Конструирует объект |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
Component |
getComponent() Возвращает |
int |
getDragAction() Возвращает |
Point |
getDragOrigin() Возвращает |
DragSource |
getDragSource() Возвращает |
DragGestureRecognizer |
getSourceAsDragGestureRecognizer() Возвращает источник как |
InputEvent |
getTriggerEvent() Возвращает исходное событие, которое инициировало жест. |
Iterator<InputEvent> |
iterator() Возвращает |
void |
startDrag(Cursor dragCursor,
Image dragImage,
Point imageOffset,
Transferable transferable,
DragSourceListener dsl) Инициализирует перетаскивание с заданным начальным |
void |
startDrag(Cursor dragCursor,
Transferable transferable) Инициализирует операцию перетаскивания с использованием |
void |
startDrag(Cursor dragCursor,
Transferable transferable,
DragSourceListener dsl) Инициализирует перетаскивание с заданным начальным |
Object[] |
toArray() Возвращает массив |
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()
Возвращает 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, 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.