Класс DragGestureRecognizer

Все реализованные интерфейсы:
Serializable
Прямые известные подклассы:
MouseDragGestureRecognizer
public abstract class DragGestureRecognizer
extends Object
implements Serializable

Класс DragGestureRecognizer является абстрактным базовым классом для спецификации платформозависимого слушателя, который может быть связан с конкретным Component для идентификации платформозависимых жестов начала перетаскивания.

Соответствующий экземпляр подкласса DragGestureRecognizer получается из DragSource, связанного с конкретным Component, или из объекта Toolkit через его метод createDragGestureRecognizer().

После того, как DragGestureRecognizer связан с конкретным Component, он зарегистрирует соответствующие интерфейсы слушателей на этом Component для отслеживания событий ввода, поступающих на Component.

После того, как DragGestureRecognizer идентифицирует последовательность событий на Component как жест начала перетаскивания, он уведомит своего одноадресного слушателя DragGestureListener вызовом его метода gestureRecognized().

Когда конкретный экземпляр DragGestureRecognizer обнаруживает жест начала перетаскивания на Component , с которым он связан, он отправляет событие DragGestureEvent зарегистрированному слушателю DragGestureListener на его одноадресном источнике событий для DragGestureListener событий. Этот DragGestureListener отвечает за запуск операции перетаскивания и перемещения (если это необходимо) с соответствующим DragSource.

См. также:
DragGestureListener, DragGestureEvent, DragSource, Форматированный вывод

Поля

Модификатор и тип Поле Описание
protected Component component

Component , связанный с этим DragGestureRecognizer.
protected DragGestureListener dragGestureListener

DragGestureListener , связанный с этим DragGestureRecognizer.
protected DragSource dragSource

DragSource , связанный с этим DragGestureRecognizer.
protected ArrayList<InputEvent> events

Список событий (в порядке), которые DragGestureRecognizer "распознал" как "жест", вызывающий перетаскивание.
protected int sourceActions

int , представляющий тип(ы) действия(й), используемого(ых) в данной операции перетаскивания и перемещения.

Конструкторы

Модификатор Конструктор Описание
protected DragGestureRecognizer​(DragSource ds)

Создать новый DragGestureRecognizer с заданным DragSource для использования в данной операции перетаскивания и перемещения.
protected DragGestureRecognizer​(DragSource ds, Component c)

Создать новый DragGestureRecognizer с заданным DragSource для использования в данной операции перетаскивания и перемещения и Component , за которым должен наблюдать этот DragGestureRecognizer для распознавания жестов начала перетаскивания.
protected DragGestureRecognizer​(DragSource ds, Component c, int sa)

Создать новый DragGestureRecognizer с заданным DragSource для использования в данной операции перетаскивания и перемещения, Component , за которым должен наблюдать этот DragGestureRecognizer для распознавания жестов начала перетаскивания, и поддерживаемыми действиями для данной операции перетаскивания и перемещения.
protected DragGestureRecognizer​(DragSource ds, Component c, int sa, DragGestureListener dgl)

Создать новый DragGestureRecognizer с заданным DragSource для использования в данной операции перетаскивания и перемещения, Component , за которым должен наблюдать этот DragGestureRecognizer для распознавания жестов начала перетаскивания, поддерживаемыми действиями для данной операции перетаскивания и перемещения и DragGestureListener для уведомления после обнаружения жеста начала перетаскивания.

Методы

Модификатор и тип Метод Описание
void addDragGestureListener​(DragGestureListener dgl)

Регистрирует новый DragGestureListener.
protected void appendEvent​(InputEvent awtie)

Слушатели, зарегистрированные на компоненте данным распознавателем, записывают все события, которые распознаны как часть серии событий, образующих жест начала перетаскивания через этот API.
protected void fireDragGestureRecognized​(int dragAction, Point p)

Уведомляет DragGestureListener о том, что произошел жест начала перетаскивания.
Component getComponent()

Данный метод возвращает Component , который должен "наблюдаться" DragGestureRecognizer для распознавания жестов начала перетаскивания.
DragSource getDragSource()

Данный метод возвращает DragSource , который этот DragGestureRecognizer будет использовать для обработки операции перетаскивания и перемещения.
int getSourceActions()

Данный метод возвращает целое число, представляющее тип действия(й), которое(ые) данная операция перетаскивания и перемещения будет поддерживать.
InputEvent getTriggerEvent()

Данный метод возвращает первое событие в серии событий, которые инициировали операцию перетаскивания и перемещения.
protected abstract void registerListeners()

регистрация слушателей данного DragGestureRecognizer с компонентом подклассы должны переопределить этот метод
void removeDragGestureListener​(DragGestureListener dgl)

отменить текущего DragGestureListener
void resetRecognizer()

Сброс распознавателя. Если он в данный момент распознаёт жест, проигнорировать его.
void setComponent​(Component c)

установить компонент, с которым связан DragGestureRecognizer. registerListeners() и unregisterListeners() вызываются как побочный эффект при необходимости.
void setSourceActions​(int actions)

Этот метод устанавливает разрешенные действия перетаскивания источника для данной операции перетаскивания и перемещения.
protected abstract void unregisterListeners()

отмена слушателей данного DragGestureRecognizer с компонентом. Подклассы должны переопределить этот метод

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

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

Поля

dragSource

protected DragSource dragSource

Источник перетаскивания, связанный с этим объектом.

component

protected Component component

Компонент, связанный с этим объектом.

dragGestureListener

protected transient DragGestureListener dragGestureListener

Обработчик жеста перетаскивания, связанный с этим объектом.

sourceActions

protected int sourceActions

Целочисленное значение, представляющее тип(ы) действия(й), используемых в операции перетаскивания.

events

protected ArrayList<InputEvent> events

Список событий (в порядке следования), которые распознаны как "жест" запуска перетаскивания.

Конструкторы

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                                Component c,
                                int sa,
                                DragGestureListener dgl)

Создаёт новый объект распознавателя жестов перетаскивания, используя заданный источник перетаскивания, компонент для наблюдения за жестами, набор поддерживаемых действий и обработчик жестов.

Параметры:
ds - источник перетаскивания, который будет использован для обработки операции перетаскивания
c - компонент, за событиями которого будет следить распознаватель, чтобы обнаружить жесты начала перетаскивания. Если значение равно null, то распознавателю не присвоен никакой компонент.
sa - набор (логическое ИЛИ) поддерживаемых действий для операции перетаскивания
dgl - обработчик жестов, который будет уведомлен при обнаружении жеста перетаскивания
Исключения:
IllegalArgumentException - если ds равен null.

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                                Component c,
                                int sa)

Создаёт новый объект распознавателя жестов перетаскивания, используя заданный источник перетаскивания, компонент для наблюдения за жестами и набор поддерживаемых действий.

Параметры:
ds - источник перетаскивания, который будет использован для обработки операции перетаскивания
c - компонент, за событиями которого будет следить распознаватель, чтобы обнаружить жесты начала перетаскивания. Если значение равно null, то распознавателю не присвоен никакой компонент.
sa - набор (логическое ИЛИ) поддерживаемых действий для операции перетаскивания
Исключения:
IllegalArgumentException - если ds равен null.

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                                Component c)

Создаёт новый объект распознавателя жестов перетаскивания, используя заданный источник перетаскивания и компонент для наблюдения за жестами.

Параметры:
ds - источник перетаскивания, который будет использован для обработки операции перетаскивания
c - компонент, за событиями которого будет следить распознаватель, чтобы обнаружить жесты начала перетаскивания. Если значение равно null, то распознавателю не присвоен никакой компонент.
Исключения:
IllegalArgumentException - если ds равен null.

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds)

Создаёт новый объект распознавателя жестов перетаскивания, используя заданный источник перетаскивания.

Параметры:
ds - источник перетаскивания, который будет использован для обработки операции перетаскивания
Исключения:
IllegalArgumentException - если ds равен null.

Методы

registerListeners

protected abstract void registerListeners()

Регистрирует обработчики событий распознавателя жестов перетаскивания. Дочерние классы компонентов должны переопределить этот метод.

unregisterListeners

protected abstract void unregisterListeners()

Дерегистрирует обработчики событий распознавателя жестов перетаскивания. Дочерние классы компонентов должны переопределить этот метод.

getDragSource

public DragSource getDragSource()

Возвращает источник перетаскивания, используемый для обработки операции перетаскивания.

Возвращает:
Источник перетаскивания

getComponent

public Component getComponent()

Возвращает компонент, за событиями которого следит распознаватель жестов перетаскивания.

Возвращает:
Компонент, с которым связан распознаватель жестов перетаскивания

setComponent

public void setComponent(Component c)

Устанавливает компонент, с которым связан распознаватель жестов перетаскивания. registerListeners() и unregisterListeners() вызываются как побочный эффект.

Параметры:
c - Компонент, с которым нужно связать распознаватель.

getSourceActions

public int getSourceActions()

Возвращает целочисленное значение, представляющее тип(ы) действий, поддерживаемых операцией перетаскивания.

Возвращает:
Текущее(ые) разрешённые действие(я) перетаскивания

setSourceActions

public void setSourceActions(int actions)

Устанавливает разрешённое действие(я) перетаскивания для данной операции перетаскивания.

Параметры:
actions - Разрешённое действие(я) перетаскивания

getTriggerEvent

public InputEvent getTriggerEvent()

Возвращает первое событие в серии событий, инициировавших операцию перетаскивания.

Возвращает:
Первоначальное событие, вызвавшее жест перетаскивания

resetRecognizer

public void resetRecognizer()

Сбрасывает распознаватель, если он в данный момент распознаёт жест — игнорирует его.

addDragGestureListener

public void addDragGestureListener(DragGestureListener dgl)
                            throws TooManyListenersException

Регистрирует нового обработчика жестов перетаскивания.

Параметры:
dgl - Обработчик жестов перетаскивания для регистрации.
Исключения:
TooManyListenersException - если обработчик уже добавлен.

removeDragGestureListener

public void removeDragGestureListener(DragGestureListener dgl)

Деактивирует текущего обработчика жестов перетаскивания.

Параметры:
dgl - Обработчик жестов перетаскивания для дерегистрации.
Исключения:
IllegalArgumentException - если dgl не совпадает с текущим зарегистрированным обработчиком.

fireDragGestureRecognized

protected void fireDragGestureRecognized(int dragAction,
                                         Point p)

Уведомляет обработчик жестов перетаскивания о том, что произошёл жест запуска операции перетаскивания. Затем сбрасывает состояние распознавателя.

Параметры:
dragAction - Действие, первоначально выбранное пользователем
p - Точка (в координатах компонента), в которой начался жест

appendEvent

protected void appendEvent(InputEvent awtie)

Обработчики, зарегистрированные на компоненте этим распознавателем, должны записывать все события, распознаваемые как часть серии событий, составляющих инициирующий жест перетаскивания, через этот API.

Этот метод используется реализацией распознавателя для добавления события (класса наследника InputEvent) в массив событий, который распознаватель сохраняет внутри.

Параметры:
awtie - Событие для добавления в внутренний массив событий распознавателя. Заметьте, что null не является допустимым значением и будет проигнорировано.

© 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/DragGestureRecognizer.html

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