Интерфейс DragSourceListener
- Все суперинтерфейсы:
EventListener
- Все известные реализующие классы:
-
DragSourceAdapter,DragSourceContext
public interface DragSourceListener extends EventListener
Интерфейс
DragSourceListener определяет интерфейс событий для инициаторов операций перетаскивания и сброса для отслеживания состояния жеста пользователя и предоставления соответствующей обратной связи «перетащить над» пользователю во время операции перетаскивания и сброса. Сайт сброса связан с предыдущим вызовом dragEnter(), если последний вызов dragEnter() в этом слушателе:
- соответствует этому сайту сброса и
- не последует за ним вызов
dragExit()в этом слушателе.
- С:
- 1.2
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
dragDropEnd |
Этот метод вызывается для обозначения завершения операции перетаскивания и сброса. |
void |
dragEnter |
Вызывается, когда горячая точка курсора входит в сайт сброса, зависящий от платформы. |
void |
dragExit |
Вызывается, когда горячая точка курсора выходит из сайта сброса, зависящего от платформы. |
void |
dragOver |
Вызывается, когда горячая точка курсора перемещается над сайтом сброса, зависящим от платформы. |
void |
dropActionChanged |
Вызывается, когда пользователь изменил жест сброса. |
Подробное описание методов
dragEnter
void dragEnter(DragSourceDragEvent dsde)
Вызывается, когда горячая точка курсора входит в сайт сброса, зависящий от платформы. Этот метод вызывается, когда выполняются все следующие условия:
- Горячая точка курсора входит в рабочую область сайта сброса, зависящего от платформы.
- Сайт сброса активен.
- Сайт сброса принимает перетаскивание.
- Параметры:
-
dsde- theDragSourceDragEvent
dragOver
void dragOver(DragSourceDragEvent dsde)
Вызывается, когда горячая точка курсора перемещается над сайтом сброса, зависящим от платформы. Этот метод вызывается, когда выполняются все следующие условия:
- Горячая точка курсора переместилась, но все еще пересекает рабочую область сайта сброса, связанного с предыдущим вызовом dragEnter().
- Сайт сброса все еще активен.
- Сайт сброса принимает перетаскивание.
- Параметры:
-
dsde- theDragSourceDragEvent
dropActionChanged
void dropActionChanged(DragSourceDragEvent dsde)
Вызывается, когда пользователь изменил жест сброса. Этот метод вызывается, когда изменяется состояние устройства(ов) ввода, с которыми взаимодействует пользователь. Такие устройства обычно представляют собой кнопки мыши или модификаторы клавиатуры, с которыми взаимодействует пользователь.
- Параметры:
-
dsde- theDragSourceDragEvent
dragExit
void dragExit(DragSourceEvent dse)
Вызывается, когда горячая точка курсора выходит из сайта сброса, зависящего от платформы. Этот метод вызывается, когда выполняется любое из следующих условий:
- Горячая точка курсора больше не пересекает рабочую область сайта сброса, связанного с предыдущим вызовом dragEnter().
- Сайт сброса, связанный с предыдущим вызовом dragEnter(), больше не активен.
- Сайт сброса, связанный с предыдущим вызовом dragEnter(), отклонил перетаскивание.
- Параметры:
-
dse- theDragSourceEvent
dragDropEnd
void dragDropEnd(DragSourceDropEvent dsde)
Этот метод вызывается для обозначения завершения операции перетаскивания и сброса. Метод getDropSuccess()
DragSourceDropEvent может использоваться для определения состояния завершения. Метод getDropAction() возвращает операцию, которую сайт сброса выбрал для применения к операции сброса. После завершения этого метода текущий DragSourceContext и связанные с ним ресурсы становятся недоступны.- Параметры:
-
dsde- theDragSourceDropEvent
© 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/DragSourceListener.html