Класс DragGestureRecognizer

java.lang.Object

java.awt.dnd.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.

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected Component`	`component`	`Component` , связанный с этим `DragGestureRecognizer`.
`protected DragGestureListener`	`dragGestureListener`	`DragGestureListener` , связанный с этим `DragGestureRecognizer`.
`protected DragSource`	`dragSource`	`DragSource` , связанный с этим `DragGestureRecognizer`.
`protected ArrayList<InputEvent>`	`events`	Список событий (в порядке), которые `DragGestureRecognizer` "распознал" как "жест", запускающий перетаскивание.
`protected int`	`sourceActions`	`int` , представляющий тип(ы) действия(й), используемых в этой операции перетаскивания и опускания.

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

DragGestureRecognizer(DragSource ds)

DragGestureRecognizer(DragSource ds,
 Component c)

DragGestureRecognizer(DragSource ds,
 Component c,
 int sa)

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

Модификатор	Конструктор	Описание
`protected`	Создает новый `DragGestureRecognizer` с заданным `DragSource`, используемым в данной операции перетаскивания.
`protected`	Создает новый `DragGestureRecognizer` с заданным `DragSource` для использования в этой операции перетаскивания и `Component` , за которым этот `DragGestureRecognizer` должен наблюдать для жестов, инициирующих перетаскивание.
`protected`	Создает новый `DragGestureRecognizer` с заданным `DragSource` для использования в данной операции перетаскивания, `Component` , за которым этот `DragGestureRecognizer` должен наблюдать для жестов, инициирующих перетаскивание, и набором действий, поддерживаемых для этой операции перетаскивания.
`protected`	Создает новый `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, регистрация и отмена слушателей вызываются как побочный эффект, если это необходимо.
`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)

Создает новый объект 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

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)

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

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

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

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/dnd/DragGestureRecognizer.html