Класс 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. В качестве побочного эффекта вызываются registerListeners() и unregisterListeners() при необходимости.
`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, 2023, 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/21/docs/api/java.desktop/java/awt/dnd/DragGestureRecognizer.html