Класс DragGestureRecognizer

java.lang.Object

java.awt.dnd.DragGestureRecognizer

Все реализуемые интерфейсы:: Serializable

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

public abstract class DragGestureRecognizer extends Object implements Serializable

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

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

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

После того, как `DragGestureRecognizer` определит последовательность событий на компоненте как жест начала перетаскивания, он уведомит своего одноадресного слушателя, вызвав метод `dragGestureRecognized`.

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

См. также:

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

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

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

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` с заданным источником перетаскивания.
`protected`	Создаёт новый объект `DragGestureRecognizer` с заданным источником перетаскивания и компонентом, за которым он должен следить.
`protected`	Создаёт новый объект `DragGestureRecognizer` с заданным источником перетаскивания, компонентом и поддерживаемыми действиями.
`protected`	Создаёт новый объект `DragGestureRecognizer` с заданным источником перетаскивания, компонентом, поддерживаемыми действиями и слушателем для уведомления о распознанном жесте.

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

Модификатор и тип	Метод	Описание
`void`	`addDragGestureListener(DragGestureListener dgl)`	Регистрирует нового слушателя.
`protected void`	`appendEvent(InputEvent awtie)`	Слушатели, зарегистрированные на компоненте этим распознавателем, записывают все события, распознанные как часть последовательности событий, составляющих жест начала перетаскивания.
`protected void`	`fireDragGestureRecognized(int dragAction, Point p)`	Уведомляет слушателя о произошедшем жесте начала перетаскивания.
`Component`	`getComponent()`	Возвращает компонент, за которым `DragGestureRecognizer` следит.
`DragSource`	`getDragSource()`	Возвращает источник перетаскивания.
`int`	`getSourceActions()`	Возвращает тип действия операции перетаскивания.
`InputEvent`	`getTriggerEvent()`	Возвращает первое событие в последовательности событий, инициировавших операцию перетаскивания.
`protected abstract void`	`registerListeners()`	Регистрирует слушателей `DragGestureRecognizer` на компоненте. Дочерние классы должны переопределить этот метод.
`void`	`removeDragGestureListener(DragGestureListener dgl)`	Дерегистрирует текущего слушателя событий перетаскивания.
`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.

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

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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/dnd/DragGestureRecognizer.html