Пакет java.awt.dnd

package java.awt.dnd

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

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

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

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

Сам жест перемещает логический курсор по иерархии GUI, пересекая геометрию компонента(ов) GUI, что может привести к тому, что логический курсор «перетаскивания» войдёт, пересечёт и затем покинет Component(ы) и соответствующие DropTarget(ы).

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

Объекты DropTarget отображают обратную связь «Перетаскивание под» пользователю, в типичном случае, отображая анимации в свои связанные GUI Component(ы) под курсором GUI.

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

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

С:: 1.2

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

Класс	Описание
Autoscroll	Во время операций перетаскивания (DnD) возможно, что пользователь захочет поместить предмет операции на область прокручиваемого элемента пользовательского интерфейса, которая в данный момент не видна пользователю.
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` с его сопутствующим `DragSource`.
DragSourceDropEvent	`DragSourceDropEvent` поступает от `DragSourceContextPeer`, через `DragSourceContext`, к методу `dragDropEnd` зарегистрированных `DragSourceListener` с их сопутствующим `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, 2021, 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/17/docs/api/java.desktop/java/awt/dnd/package-summary.html