Пакет java.awt.dnd

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

См.: Описание

Сводка интерфейса

Интерфейс	Описание
Автопрокрутить	Во время операций DnD возможно, что пользователь может хотеть отбросить предмет работы на области управления GUI с возможностью прокрутки, которое не в настоящий момент видимо пользователю.
DragGestureListener	Интерфейс слушателя для того, чтобы получить перетаскивает события жеста.
DragSourceListener	DragSourceListener определяет интерфейс события для инициаторов, Перетаскивают, и операции Отбрасывания, чтобы отследить состояние жеста пользователя, и обеспечить соответствующий "перетаскивают по" обратной связи пользователю в течение работы Перетаскивания и Отбрасывания.
DragSourceMotionListener	Интерфейс слушателя для того, чтобы получить события движения мыши во время перетащить работы.
DropTargetListener	DropTargetListener интерфейс является интерфейсом обратного вызова, используемым DropTarget class, чтобы обеспечить уведомление об операциях DnD, которые включают предмет DropTarget.

Сводка класса

Класс	Описание
DnDConstants	Этот class содержит постоянные величины, представляющие тип действия (й), которое будет выполняться работой Перетаскивания и Отбрасывания.
DragGestureEvent	A DragGestureEvent к передают DragGestureListener's dragGestureRecognized () метод, когда деталь DragGestureRecognizer обнаруживает, что зависимая платформа перетаскивает жест инициирования, произошел на Component то, что это отслеживает.
DragGestureRecognizer	DragGestureRecognizer абстрактный class для спецификации зависимого от платформы слушателя, который может быть связан с деталью Component чтобы идентифицировать зависимый от платформы, перетаскивают жесты инициирования.
DragSource	DragSource объект, ответственный за инициирование работы Перетаскивания и Отбрасывания, и может использоваться во многих сценариях: 1 экземпляр по умолчанию на JVM для времени жизни той JVM.
DragSourceAdapter	Абстрактный адаптер class для того, чтобы получить перетаскивает исходные события.
DragSourceContext	DragSourceContext class ответственен за управление стороной инициатора протокола Перетаскивания и Отбрасывания.
DragSourceDragEvent	DragSourceDragEvent поставляется от DragSourceContextPeer, через DragSourceContext, к DragSourceListener зарегистрированный в этом DragSourceContext и с его связанным DragSource.
DragSourceDropEvent	DragSourceDropEvent поставляется от DragSourceContextPeer, через DragSourceContext, к dragDropEnd метод DragSourceListeners зарегистрированный в этом DragSourceContext и с его связанным DragSource.
DragSourceEvent	Этим class является основной class для DragSourceDragEvent и DragSourceDropEvent.
DropTarget	DropTarget связывается с a Component когда это Component пожелания принять отбрасывания во время Перетаскивают и операции Отбрасывания.
DropTarget. DropTargetAutoScroller	этот защищенный вложенный class реализует автопрокрутку
DropTargetAdapter	Абстрактный адаптер class для того, чтобы получить отбрасывание предназначается для событий.
DropTargetContext	A DropTargetContext создается всякий раз, когда логический курсор, связанный с работой Перетаскивания и Отбрасывания, совпадает с видимой геометрией a Component связанный с a DropTarget.
DropTargetDragEvent	DropTargetDragEvent поставляется a DropTargetListener через его dragEnter () и dragOver () методы.
DropTargetDropEvent	DropTargetDropEvent поставляется через DropTargetListener отбрасывание () метод.
DropTargetEvent	DropTargetEvent основной class для обоих DropTargetDragEvent и DropTargetDropEvent.
MouseDragGestureRecognizer	Этот абстрактный подкласс DragGestureRecognizer определяет a DragGestureRecognizer для основанных на мыши жестов.

Сводка исключения

Исключение	Описание
InvalidDnDOperationException	Это исключение выдается различными методами в java.awt.dnd пакете.

Пакет java.awt.dnd Описание

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

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

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

• A DragSource появляется, связанный с некоторым элементом представления (Component) в GUI, чтобы инициировать Перетаскивание и Отбрасывание некоторых потенциально Transferable данные.

• 1 или больше DropTarget(s) приезжайте в/выходить существование, связанное с элементами представления в GUI (Компоненты), потенциально способные к потреблению Transferable типы данных.

• A DragGestureRecognizer получается из DragSource и связывается с a Component чтобы отследить и идентифицировать, любой Перетаскивает жест инициирования пользователем по Component.

• Пользователь делает Перетащить жест по Component, который зарегистрированный DragGestureRecognizer обнаруживает, и уведомляет DragGestureListener из.

  Отметьте: Хотя этот API последовательно обращается к стимулу для работы перетаскивания и отбрасывания, являющейся физическим жестом человеческим пользователем, это не устраняет программно управляемую работу DnD, данную соответствующую реализацию a DragSource. Этот пакет содержит абстрактный class MouseDragGestureRecognizer для того, чтобы распознать жесты устройства мыши. Другие абстрактные подклассы могут быть обеспечены платформой, чтобы поддерживать другие устройства ввода данных или определенный Component Семантика class.

• DragGestureListener причины DragSource инициировать работу Перетаскивания и Отбрасывания от имени пользователя, возможно анимируя Курсор GUI и/или представляя Image из элемента (ов), которые являются предметом работы.

• Поскольку пользовательские жесты перемещаются Component(s) в GUI со связанным DropTarget(s), DragSource получает уведомления, чтобы обеспечить, "Перетаскивают По" эффектам обратной связи, и DropTarget(s) получите уведомления, чтобы обеспечить, "Перетаскивают Под" эффектами обратной связи, основанными на поддерживаемой работе (ах) и включенный тип (ы) данных.

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

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

DropTarget декларация объектов "Перетаскивает Под" обратной связью пользователю, в типичном случае, представляя анимации в их связанном GUI Component(s) под Курсором GUI.

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

• Передачей "работа", выбранная пользователем, и поддерживаемый обоими DragSource и DropTarget: Копия, Перемещение или Ссылка (ссылка).

• Пересечением набора типов данных, обеспеченных DragSource и набор типов данных, постижимых DropTarget.

• Когда пользователь завершает перетащить работу, обычно приводящую к успешному Отбрасыванию, оба DragSource и DropTarget получите уведомления, которые включают, и результат в согласовании типа и передаче, информация, связанная с DragSource через a Transferable объект.

##### FILL IN ANY SPECS NEEDED BY JAVA COMPATIBILITY KIT #####

• ##### REFER TO ANY FRAMEMAKER SPECIFICATION HERE #####

Related Documentation

For overviews, tutorials, examples, guides, and tool documentation, please see:

• ##### REFER TO NON-SPEC DOCUMENTATION HERE #####

-->

С тех пор:

1.2