Пакет java.awt.dnd

package java.awt.dnd

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

Этот пакет определяет классы и интерфейсы, необходимые для выполнения операций перетаскивания в Java. Он определяет классы для источника перетаскивания и целевого объекта, а также события для передачи перетаскиваемых данных. Этот пакет также предоставляет средства для предоставления визуальной обратной связи пользователю на протяжении всего процесса перетаскивания.

Типичная операция перетаскивания может быть разбита на следующие состояния (не обязательно последовательно):

Возникает DragSource, связанный с каким-либо элементом представления (Component) в графическом интерфейсе, для инициирования перетаскивания некоторых потенциально Transferable данных.
1 или более DropTarget(ов) возникают/исчезают, связанные с элементами представления в графическом интерфейсе (компонентами), потенциально способными потреблять Transferable типы данных.
DragGestureRecognizer извлекается из DragSource и связывается с Component для отслеживания и идентификации любых жестов инициирования перетаскивания пользователем над Component.
Пользователь выполняет жест перетаскивания над Component, который регистрируемый DragGestureRecognizer обнаруживает и уведомляет свой DragGestureListener об этом.
Примечание: Хотя этот API постоянно ссылается на стимул для операции перетаскивания как на физический жест пользователя, это не исключает программно управляемой операции перетаскивания при соответствующей реализации DragSource. Этот пакет содержит абстрактный класс MouseDragGestureRecognizer для распознавания жестов устройства мыши. Другие абстрактные подклассы могут предоставляться платформой для поддержки других устройств ввода или конкретных семантик класса Component.
DragGestureListener вызывает DragSource для инициирования операции перетаскивания от имени пользователя, возможно, анимируя курсор графического интерфейса и/или отображая Image элементов, которые являются объектом операции.
Когда пользователь перемещает курсор над Component(ами) в графическом интерфейсе с соответствующими DropTarget(ами), DragSource получает уведомления для предоставления эффектов обратной связи "Перетаскивание над", а DropTarget(ы) получают уведомления для предоставления эффектов обратной связи "Перетаскивание под" на основе поддерживаемых операций и типов данных.

Сам жест перемещает логический курсор по иерархии графического интерфейса, пересекая геометрию компонентов графического интерфейса, что может привести к тому, что логический курсор "Перетаскивания" войдет, пересечет и впоследствии покинет Component(ы) и соответствующие DropTarget(ы).

Объект DragSource отображает обратную связь "Перетаскивание над" пользователю, обычно анимируя графический Cursor , связанный с логическим курсором.

Объекты DropTarget отображают обратную связь "Перетаскивание под" пользователю, обычно отображая анимации в их соответствующих графических Component(ах) под курсором графического интерфейса.

Определение эффектов обратной связи и окончательного успеха или неудачи передачи данных, если таковая имеет место, параметризовано следующим образом:

Выбранной пользователем операцией перетаскивания и поддерживаемой как источником, так и приемником: Копирование, Перемещение или Ссылка(ссылка).
Пересечением набора типов данных, предоставляемых источником, и набора типов данных, понятных приемнику.
Когда пользователь завершает операцию перетаскивания, обычно приводящую к успешной передаче, как источник, так и приемник получают уведомления, включающие и приводящие к согласованию типа и передаче информации, связанной с DragSource через объект Transferable.

Since:: 1.2

Пакет	Описание
java.awt	Содержит все классы для создания пользовательских интерфейсов, рисования графики и изображений.

Класс	Описание
Autoscroll	Во время операций перетаскивания и сбрасывания пользователь может захотеть опустить предмет операции на область прокручиваемого элемента управления графическим интерфейсом, которая в данный момент не видна пользователю.
DnDConstants	Этот класс содержит постоянные значения, представляющие тип действия(й), которые должны быть выполнены операцией перетаскивания и сбрасывания.
DragGestureEvent	A `DragGestureEvent` передаётся методу dragGestureRecognized() `DragGestureListener` когда определенный `DragGestureRecognizer` обнаруживает, что на отслеживаемом `Component` произошла платформа-зависимая жестикуляция начала перетаскивания.
DragGestureListener	Интерфейс слушателя для получения событий жестикуляции перетаскивания.
DragGestureRecognizer	`DragGestureRecognizer` — это абстрактный базовый класс для задания платформо-зависимого слушателя, который может быть связан с конкретным `Component` для идентификации платформа-зависимых жестикуляций начала перетаскивания.
DragSource	`DragSource` — это сущность, ответственная за инициирование операции перетаскивания и сбрасывания, и может быть использована в ряде сценариев: 1 экземпляр по умолчанию на JVM на протяжении жизни этой JVM.
DragSourceAdapter	Абстрактный адаптерный класс для получения событий источника перетаскивания.
DragSourceContext	Класс `DragSourceContext` отвечает за управление инициатором стороны протокола перетаскивания и сбрасывания.
DragSourceDragEvent	`DragSourceDragEvent` поступает от `DragSourceContextPeer`, через `DragSourceContext`, к `DragSourceListener` зарегистрированному с этим `DragSourceContext` и его связанным `DragSource`.
DragSourceDropEvent	`DragSourceDropEvent` поступает от `DragSourceContextPeer`, через `DragSourceContext`, к методу `dragDropEnd` `DragSourceListener` зарегистрированному с этим `DragSourceContext` и его связанным `DragSource`.
DragSourceEvent	Этот класс — базовый класс для `DragSourceDragEvent` и `DragSourceDropEvent`.
DragSourceListener	`DragSourceListener` определяет интерфейс событий для инициаторов операций перетаскивания и сбрасывания для отслеживания состояния жестикуляции пользователя и предоставления соответствующей обратной связи «перетаскивание над» пользователю на протяжении всей операции перетаскивания и сбрасывания.
DragSourceMotionListener	Интерфейс слушателя для получения событий движения мыши во время операции перетаскивания.
DropTarget	`DropTarget` ассоциируется с `Component`, когда этот `Component` желает принять сбросы во время операций перетаскивания и сбрасывания.
DropTarget.DropTargetAutoScroller	Этот защищённый вложенный класс реализует автоматическую прокрутку.
DropTargetAdapter	Абстрактный адаптерный класс для получения событий целевых областей сброса.
DropTargetContext	`DropTargetContext` создаётся всякий раз, когда логический курсор, связанный с операцией перетаскивания и сбрасывания, совпадает с видимой геометрией `Component`, связанной с `DropTarget`.
DropTargetDragEvent	`DropTargetDragEvent` передаётся `DropTargetListener` через его методы dragEnter() и dragOver().
DropTargetDropEvent	`DropTargetDropEvent` передаётся через метод drop() `DropTargetListener`.
DropTargetEvent	`DropTargetEvent` — это базовый класс как для `DropTargetDragEvent`, так и для `DropTargetDropEvent`.
DropTargetListener	Интерфейс `DropTargetListener` — это интерфейс обратного вызова, используемый классом `DropTarget` для предоставления уведомлений об операциях перетаскивания и сбрасывания, которые включают предмет `DropTarget`.
InvalidDnDOperationException	Это исключение выбрасывается различными методами в пакете java.awt.dnd.
MouseDragGestureRecognizer	Этот абстрактный подкласс `DragGestureRecognizer` определяет `DragGestureRecognizer` для жестикуляций, основанных на мыши.

© 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/package-summary.html