Класс 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()`	Этот метод возвращает int, представляющий типы действий, поддерживаемых этой операцией перетаскивания.
`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 на компоненте; подклассы должны переопределить этот метод.

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

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

Подробное описание полей

dragSource

protected DragSource dragSource

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

component

protected Component component

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

dragGestureListener

protected transient DragGestureListener dragGestureListener

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

sourceActions

protected int sourceActions

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

events

protected ArrayList<InputEvent> events

Список событий (в порядке их поступления), которые DragGestureRecognizer «распознал» как «жест», инициирующий перетаскивание.

Подробное описание конструкторов

DragGestureRecognizer

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

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

Параметры:: ds — DragSource, который этот DragGestureRecognizer будет использовать для выполнения операции перетаскивания; c — Component, за которым этот DragGestureRecognizer должен «наблюдать» в потоке событий для обнаружения жеста, инициирующего перетаскивание. Если это значение равно null, DragGestureRecognizer не связан ни с одним Component.; sa — набор (логическое ИЛИ) DnDConstants, поддерживаемых этой операцией перетаскивания; dgl — DragGestureRecognizer, который нужно уведомить при обнаружении жеста перетаскивания
Исключения:: IllegalArgumentException — если ds равно null.

DragGestureRecognizer

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

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

Параметры:: ds — DragSource, который этот DragGestureRecognizer будет использовать для выполнения операции перетаскивания; c — Component, за которым этот DragGestureRecognizer должен «наблюдать» в потоке событий для обнаружения жеста, инициирующего перетаскивание. Если это значение равно null, DragGestureRecognizer не связан ни с одним Component.; sa — набор (логическое ИЛИ) DnDConstants, поддерживаемых этой операцией перетаскивания
Исключения:: IllegalArgumentException — если ds равно null.

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds, Component c)

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

Параметры:: ds — DragSource, который этот DragGestureRecognizer будет использовать для выполнения операции перетаскивания; c — Component, за которым этот DragGestureRecognizer должен «наблюдать» в потоке событий для обнаружения жеста, инициирующего перетаскивание. Если это значение равно null, DragGestureRecognizer не связан ни с одним Component.
Исключения:: IllegalArgumentException — если ds равно null.

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds)

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

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

Подробное описание методов

registerListeners

protected abstract void registerListeners()

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

unregisterListeners

protected abstract void unregisterListeners()

Отменяет регистрацию прослушивателей этого DragGestureRecognizer на компоненте; подклассы должны переопределить этот метод.

getDragSource

public DragSource getDragSource()

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

Возвращает:: DragSource

getComponent

public Component getComponent()

Этот метод возвращает Component, за которым DragGestureRecognizer должен «наблюдать» для обнаружения жестов, инициирующих перетаскивание.

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

setComponent

public void setComponent(Component c)

Задаёт компонент, с которым связан DragGestureRecognizer; при необходимости в качестве побочного эффекта вызываются registerListeners() и unregisterListeners().

Параметры:: c — Component или null

getSourceActions

public int getSourceActions()

Этот метод возвращает int, представляющий типы действий, поддерживаемых этой операцией перетаскивания.

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

setSourceActions

public void setSourceActions(int actions)

Этот метод задаёт разрешённые исходные действия перетаскивания для данной операции перетаскивания.

Параметры:: actions — разрешённые исходные действия перетаскивания

getTriggerEvent

public InputEvent getTriggerEvent()

Этот метод возвращает первое событие в последовательности событий, инициировавших операцию перетаскивания.

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

resetRecognizer

public void resetRecognizer()

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

addDragGestureListener

public void addDragGestureListener(DragGestureListener dgl) throws TooManyListenersException

Регистрирует новый DragGestureListener.

Параметры:: dgl — DragGestureListener, который нужно зарегистрировать в этом DragGestureRecognizer.
Исключения:: TooManyListenersException — если DragGestureListener уже был добавлен.

removeDragGestureListener

public void removeDragGestureListener(DragGestureListener dgl)

Отменяет регистрацию текущего DragGestureListener.

Параметры:: dgl — DragGestureListener, регистрацию которого нужно отменить в этом DragGestureRecognizer
Исключения:: IllegalArgumentException — если dgl не равен текущему зарегистрированному DragGestureListener.

fireDragGestureRecognized

protected void fireDragGestureRecognized(int dragAction, Point p)

Уведомляет DragGestureListener о возникновении жеста, инициирующего операцию перетаскивания. Затем сбрасывает состояние распознавателя.

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

appendEvent

protected void appendEvent(InputEvent awtie)

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

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

Параметры:: awtie — InputEvent, который нужно добавить во внутренний массив событий этого DragGestureRecognizer. Обратите внимание, что 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/dnd/DragGestureRecognizer.html