Пакет 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.