Интерфейс 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, 2023, 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/21/docs/api/java.desktop/java/awt/dnd/DragSourceListener.html