Пакет 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 отображает обратную связь «перетаскивание над» пользователю, в типичном случае, анимируя курсор графического интерфейса, связанный с логическим курсором.

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

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

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