Интерфейс DragSourceListener

public interface DragSourceListener
extends EventListener

Интерфейс DragSourceListener определяет интерфейс событий для инициаторов операций перетаскивания и опускания (Drag and Drop), чтобы отслеживать состояние жеста пользователя и предоставлять соответствующую обратную связь «перетаскивания над» пользователю на протяжении всей операции перетаскивания и опускания.

Сайт опускания связан с предыдущим вызовом dragEnter(), если последний вызов dragEnter() данного слушателя:

• соответствует этому сайту опускания и
• не сопровождается вызовом dragExit() данного слушателя.

Методы

dragEnter

void dragEnter(DragSourceDragEvent dsde)

Вызывается при входе горячей точки курсора на платформенно-зависимый сайт опускания. Этот метод вызывается, когда все следующие условия выполняются:

• Горячая точка курсора входит в рабочую часть платформенно-зависимого сайта опускания.
• Сайт опускания активен.
• Сайт опускания принимает перетаскивание.

Параметры:

dsde - the DragSourceDragEvent

dragOver

void dragOver(DragSourceDragEvent dsde)

Вызывается при перемещении горячей точки курсора над платформенно-зависимым сайтом опускания. Этот метод вызывается, когда все следующие условия выполняются:

• Горячая точка курсора переместилась, но все еще пересекает рабочую часть сайта опускания, связанного с предыдущим вызовом dragEnter().
• Сайт опускания по-прежнему активен.
• Сайт опускания принимает перетаскивание.

Параметры:

dsde - the DragSourceDragEvent

dropActionChanged

void dropActionChanged(DragSourceDragEvent dsde)

Вызывается, когда пользователь изменил жест опускания. Этот метод вызывается, когда изменяется состояние устройства(ов) ввода, с которыми взаимодействует пользователь. Такие устройства обычно представляют собой кнопки мыши или модификаторы клавиатуры, с которыми взаимодействует пользователь.

Параметры:

dsde - the DragSourceDragEvent

dragExit

void dragExit(DragSourceEvent dse)

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

• Горячая точка курсора больше не пересекает рабочую часть сайта опускания, связанного с предыдущим вызовом dragEnter().

ИЛИ

• Сайт опускания, связанный с предыдущим вызовом dragEnter(), больше не активен.

ИЛИ

• Сайт опускания, связанный с предыдущим вызовом dragEnter(), отклонил перетаскивание.

Параметры:

dse - the DragSourceEvent

dragDropEnd

void dragDropEnd(DragSourceDropEvent dsde)

Этот метод вызывается для обозначения завершения операции перетаскивания и опускания. Метод getDropSuccess() объекта DragSourceDropEvent можно использовать для определения состояния завершения. Метод getDropAction() возвращает операцию, выбранную сайтом опускания для применения к операции опускания. После завершения этого метода текущий DragSourceContext и связанные с ним ресурсы становятся недоступными.

Параметры:

dsde - the DragSourceDropEvent