Класс DragSourceDragEvent
- java.lang.Object
-
- java.util.EventObject
-
- java.awt.dnd.DragSourceEvent
-
- java.awt.dnd.DragSourceDragEvent
- Все реализованные интерфейсы:
- Serializable
public class DragSourceDragEvent extends DragSourceEvent
Событие DragSourceDragEvent поступает от DragSourceContextPeer, через DragSourceContext, к DragSourceListener , зарегистрированному с данным DragSourceContext и его связанным DragSource.
Событие DragSourceDragEvent сообщает о целевом действии при падении и действии пользователя при падении, которые отражают текущее состояние операции перетаскивания.
Целевое действие при падении является одним из DnDConstants, представляющих действие при падении, выбранное текущей целевой точкой падения, если это действие поддерживается источником перетаскивания, или DnDConstants.ACTION_NONE , если это действие не поддерживается источником перетаскивания.
Действие пользователя при падении зависит от действий при падении, поддерживаемых источником перетаскивания, и от действия при падении, выбранного пользователем. Пользователь может выбрать действие при падении, нажимая клавиши модификаторов во время операции перетаскивания:
Ctrl + Shift -> ACTION_LINK Ctrl -> ACTION_COPY Shift -> ACTION_MOVEЕсли пользователь выбирает действие при падении, действие пользователя при падении является одним из
DnDConstants, представляющих выбранное действие при падении, если это действие поддерживается источником перетаскивания, или DnDConstants.ACTION_NONE , если это действие не поддерживается источником перетаскивания. Если пользователь не выбирает действие при падении, множество DnDConstants, представляющих множество поддерживаемых действий при падении, ищется DnDConstants.ACTION_MOVE, затем DnDConstants.ACTION_COPY, затем DnDConstants.ACTION_LINK, и действие пользователя при падении — это первая найденная константа. Если никакая константа не найдена, действие пользователя при падении — DnDConstants.ACTION_NONE.
- С тех пор как:
- 1.2
- См. также:
- Сериализованная форма
Поля
Поля, унаследованные от класса java.util.EventObject
source Конструкторы
| Конструктор и описание |
|---|
DragSourceDragEvent(DragSourceContext dsc,
int dropAction,
int action,
int modifiers) Конструирует |
DragSourceDragEvent(DragSourceContext dsc,
int dropAction,
int action,
int modifiers,
int x,
int y) Конструирует |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
int |
getDropAction() Этот метод возвращает логическое пересечение целевого действия при падении и набора действий при падении, поддерживаемых источником перетаскивания. |
int |
getGestureModifiers() Этот метод возвращает |
int |
getGestureModifiersEx() Этот метод возвращает |
int |
getTargetActions() Этот метод возвращает целевое действие при падении. |
int |
getUserAction() Этот метод возвращает действие пользователя при падении. |
Методы, унаследованные от класса java.awt.dnd.DragSourceEvent
getDragSourceContext, getLocation, getX, getY Методы, унаследованные от класса java.util.EventObject
getSource, toString Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait Конструкторы
DragSourceDragEvent
public DragSourceDragEvent(DragSourceContext dsc,
int dropAction,
int action,
int modifiers) Конструирует DragSourceDragEvent. Этот класс обычно создается DragSourceContextPeer, а не напрямую кодом клиента. Координаты для этого DragSourceDragEvent не указаны, поэтому getLocation вернет null для этого события.
Аргументы dropAction и action должны быть одним из DnDConstants, представляющим одно действие. Аргумент modifiers должен быть либо битовой маской старых констант java.awt.event.InputEvent.*_MASK, либо битовой маской расширенных констант java.awt.event.InputEvent.*_DOWN_MASK. Этот конструктор не выбрасывает исключений для недействительных dropAction, action и modifiers.
- Параметры:
-
dsc-DragSourceContext, который будет управлять уведомлениями об этом событии. -
dropAction- действие пользователя при падении. -
action- целевое действие при падении. -
modifiers- клавиши модификаторов, нажатые во время события (Shift, Ctrl, Alt, Meta). Следует использовать либо расширенные _DOWN_MASK, либо старые _MASK модификаторы, но оба типа не должны смешиваться в одном событии. Рекомендуется использовать расширенные модификаторы. - Исключения:
-
IllegalArgumentException- еслиdscявляетсяnull. - См. также:
-
InputEvent,DragSourceEvent.getLocation()
DragSourceDragEvent
public DragSourceDragEvent(DragSourceContext dsc,
int dropAction,
int action,
int modifiers,
int x,
int y) Конструирует DragSourceDragEvent с заданным DragSourceContext, действием пользователя при падении, целевым действием при падении, модификаторами и координатами.
Аргументы dropAction и action должны быть одним из DnDConstants, представляющим одно действие. Аргумент modifiers должен быть либо битовой маской старых констант java.awt.event.InputEvent.*_MASK, либо битовой маской расширенных констант java.awt.event.InputEvent.*_DOWN_MASK. Этот конструктор не выбрасывает исключений для недействительных dropAction, action и modifiers.
- Параметры:
-
dsc-DragSourceContext, связанный с этим событием. -
dropAction- действие пользователя при падении. -
action- целевое действие при падении. -
modifiers- клавиши модификаторов, нажатые во время события (Shift, Ctrl, Alt, Meta). Следует использовать либо расширенные _DOWN_MASK, либо старые _MASK модификаторы, но оба типа не должны смешиваться в одном событии. Рекомендуется использовать расширенные модификаторы. -
x- горизонтальная координата для местоположения курсора -
y- вертикальная координата для местоположения курсора - Исключения:
-
IllegalArgumentException- еслиdscявляетсяnull. - С тех пор как:
- 1.4
- См. также:
InputEvent
Методы
getTargetActions
public int getTargetActions()
Этот метод возвращает целевое действие при падении.
- Возвращает:
- целевое действие при падении.
getGestureModifiers
public int getGestureModifiers()
Этот метод возвращает int , представляющее текущее состояние модификаторов устройства ввода, связанных с жестом пользователя. Обычно это кнопки мыши или клавиши модификаторов.
Если modifiers , переданные в конструктор, недействительны, этот метод возвращает их без изменений.
- Возвращает:
- текущее состояние модификаторов устройства ввода
getGestureModifiersEx
public int getGestureModifiersEx()
Этот метод возвращает int, представляющее текущее состояние расширенных модификаторов устройства ввода, связанных с жестом пользователя. См. InputEvent.getModifiersEx()
Если modifiers , переданные в конструктор, недействительны, этот метод возвращает их без изменений.
- Возвращает:
- текущее состояние расширенных модификаторов устройства ввода
- С тех пор как:
- 1.4
getUserAction
public int getUserAction()
Этот метод возвращает действие пользователя при падении.
- Возвращает:
- действие пользователя при падении.
getDropAction
public int getDropAction()
Этот метод возвращает логическое пересечение целевого действия при падении и множества действий при падении, поддерживаемых источником перетаскивания.
- Возвращает:
- логическое пересечение целевого действия при падении и множества действий при падении, поддерживаемых источником перетаскивания.
© 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.