Класс DragGestureRecognizer

java.lang.Object
- java.awt.dnd.DragGestureRecognizer

Все реализованные интерфейсы:: Serializable

Непосредственные известные подклассы:: MouseDragGestureRecognizer

public abstract class DragGestureRecognizer
extends Object
implements Serializable

Абстрактный базовый класс для задания платформозависимого слушателя, который может быть связан с конкретным 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 на подклассах Component, необходимо переопределить этот метод
`void`	`removeDragGestureListener(DragGestureListener dgl)` отменить текущего DragGestureListener
`void`	`resetRecognizer()` Сбросить распознаватель. Если в данный момент он распознает жест, проигнорировать его.
`void`	`setComponent(Component c)` установить компонент, с которым связан DragGestureRecognizer. registerListeners() и unregisterListeners() вызываются как побочный эффект по мере необходимости.
`void`	`setSourceActions(int actions)` Этот метод задаёт разрешенные действия перетаскивания источника для данной операции перетаскивания и опускания.
`protected abstract void`	`unregisterListeners()` отменить слушателей данного DragGestureRecognizer на подклассах Component, необходимо переопределить этот метод

Методы, унаследованные от класса 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)

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

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

DragGestureRecognizer

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

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

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

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                                Component c)

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

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

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds)

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

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

Методы

registerListeners

protected abstract void registerListeners()

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

unregisterListeners

protected abstract void unregisterListeners()

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

getDragSource

public DragSource getDragSource()

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

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

getComponent

public Component getComponent()

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

Возвращает:: Компонент, с которым связан DragGestureRecognizer

setComponent

public void setComponent(Component c)

Устанавливает компонент, с которым связан DragGestureRecognizer. 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)

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

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

Параметры:: 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.