Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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.