java.awt.dnd

Класс DragSource

java.lang. Объект

java.awt.dnd. DragSource

Все Реализованные Интерфейсы:

Сериализуемый

public class DragSource
extends Object
implements Serializable

DragSource объект, ответственный за инициирование работы Перетаскивания и Отбрасывания, и может использоваться во многих сценариях:

• 1 экземпляр по умолчанию на JVM для времени жизни той JVM.
• 1 экземпляр на class потенциала Перетаскивает объект Инициатора (например, TextField). [зависящий от реализации]
• 1 на экземпляр детали Component, или специализированный объект связался с a Component экземпляр в GUI. [зависящий от реализации]
• Некоторая другая произвольная ассоциация. [зависящий от реализации]

Однажды DragSource получается, a DragGestureRecognizer должен также быть получен, чтобы связаться DragSource с деталью Component.

Начальная интерпретация жеста пользователя, и последующий запуск перетащить работы являются ответственностью реализации Component, который обычно реализуется a DragGestureRecognizer.

Когда перетащить жест происходит, DragSource's startDrag () метод должен быть вызван, чтобы вызвать обработку навигационных жестов пользователя, и поставка Перетаскивают и уведомления о протоколе Отбрасывания. A DragSource только разрешу, чтобы сингл Перетащил и работа Отбрасывания, чтобы быть текущим в любой момент, и должен отклонить дальше startDrag () запросы, бросая IllegalDnDOperationException до тех пор, пока существующая работа полна.

startDrag () метод вызывает createDragSourceContext () метод, чтобы инстанцировать соответствующего DragSourceContext и партнер DragSourceContextPeer с этим.

Если Система Перетаскивания и Отбрасывания неспособна инициировать перетащить работу по некоторым причинам, startDrag (), метод бросает a java.awt.dnd.InvalidDnDOperationException сигнализировать такое условие. Обычно это исключение выдается, когда базовая система платформы или не в состоянии, чтобы инициировать перетаскивание, или определенные параметры недопустимы.

Отметьте, что во время перетаскивания, набор операций, представленных источником в начале перетащить работы, возможно, не изменяется, пока работа не полна. Работа (ы) является постоянной для продолжительности работы относительно DragSource.

С тех пор:

1.2

См. Также:

Сериализированная Форма

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static Cursor	DefaultCopyDrop Значение по умолчанию Cursor использовать с работой копии, указывающей, что отбрасывание в настоящий момент позволяется.
static Cursor	DefaultCopyNoDrop Значение по умолчанию Cursor использовать с работой копии, указывающей, что отбрасывание в настоящий момент не позволяется.
static Cursor	DefaultLinkDrop Значение по умолчанию Cursor использовать с работой ссылки, указывающей, что отбрасывание в настоящий момент позволяется.
static Cursor	DefaultLinkNoDrop Значение по умолчанию Cursor использовать с работой ссылки, указывающей, что отбрасывание в настоящий момент не позволяется.
static Cursor	DefaultMoveDrop Значение по умолчанию Cursor использовать с операцией пересылки, указывающей, что отбрасывание в настоящий момент позволяется.
static Cursor	DefaultMoveNoDrop Значение по умолчанию Cursor использовать с операцией пересылки, указывающей, что отбрасывание в настоящий момент не позволяется.

Сводка конструктора

Конструкторы

Конструктор и Описание
DragSource() Создает новое DragSource.

Сводка метода

Модификатор и Тип	Метод и Описание
void	addDragSourceListener(DragSourceListener dsl) Добавляет указанное DragSourceListener к этому DragSource чтобы получить перетаскивают исходные события во время, перетаскивают операции intiated с этим DragSource.
void	addDragSourceMotionListener(DragSourceMotionListener dsml) Добавляет указанное DragSourceMotionListener к этому DragSource чтобы получить перетаскивают события движения во время, перетаскивают операции intiated с этим DragSource.
DragGestureRecognizer	createDefaultDragGestureRecognizer(Component c, int actions, DragGestureListener dgl) Создает новое DragGestureRecognizer это реализует подкласс краткого обзора значения по умолчанию DragGestureRecognizer для этого DragSource, и устанавливает указанное Component и DragGestureListener на недавно создаваемом объекте.
<T extends DragGestureRecognizer> T	createDragGestureRecognizer(Class<T> recognizerAbstractClass, Component c, int actions, DragGestureListener dgl) Создает новое DragGestureRecognizer это реализует указанный абстрактный подкласс DragGestureRecognizer, и устанавливает указанное Component и DragGestureListener на недавно создаваемом объекте.
protected DragSourceContext	createDragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent dgl, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable t, DragSourceListener dsl) Создает DragSourceContext чтобы обработать ток перетаскивают работу.
static DragSource	getDefaultDragSource() Добирается DragSource объект связался с базовой платформой.
DragSourceListener[]	getDragSourceListeners() Добирается весь DragSourceListeners зарегистрированный в этом DragSource.
DragSourceMotionListener[]	getDragSourceMotionListeners() Получает весь из DragSourceMotionListeners зарегистрированный в этом DragSource.
static int	getDragThreshold() Возвраты перетащить порог движения жеста.
FlavorMap	getFlavorMap() Этот метод возвращается FlavorMap для этого DragSource.
<T extends EventListener> T[]	getListeners(Class<T> listenerType) Получает все объекты, в настоящий момент зарегистрированные как FooListeners на это DragSource.
static boolean	isDragImageSupported() Отчеты, перетаскивают ли Image поддержка доступна на базовой платформе.
void	removeDragSourceListener(DragSourceListener dsl) Удаляет указанное DragSourceListener от этого DragSource.
void	removeDragSourceMotionListener(DragSourceMotionListener dsml) Удаляет указанное DragSourceMotionListener от этого DragSource.
void	startDrag(DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point dragOffset, Transferable transferable, DragSourceListener dsl) Запустите перетаскивание, данный DragGestureEvent это инициировало перетаскивание, начальную букву Cursor использовать, Image перетащить, смещение Image источник от горячей точки Cursor в момент триггера, подчиненные данные перетаскивания, и DragSourceListener.
void	startDrag(DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl, FlavorMap flavorMap) Запустите перетаскивание, данный DragGestureEvent это инициировало перетаскивание, начальную букву Cursor использовать, Image перетащить, смещение Image источник от горячей точки Cursor в момент триггера, Transferable подчиненные данные перетаскивания, DragSourceListener, и FlavorMap.
void	startDrag(DragGestureEvent trigger, Cursor dragCursor, Transferable transferable, DragSourceListener dsl) Запустите перетаскивание, данный DragGestureEvent это инициировало перетаскивание, начальную букву Cursor использовать, Transferable подчиненные данные перетаскивания, и DragSourceListener.
void	startDrag(DragGestureEvent trigger, Cursor dragCursor, Transferable transferable, DragSourceListener dsl, FlavorMap flavorMap) Запустите перетаскивание, данный DragGestureEvent это инициировало перетаскивание, начальную букву Cursor использовать, Transferable подчиненные данные перетаскивания, DragSourceListener, и FlavorMap.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

DefaultCopyDrop

public static final Cursor DefaultCopyDrop

Значение по умолчанию Cursor использовать с работой копии, указывающей, что отбрасывание в настоящий момент позволяется. null если GraphicsEnvironment.isHeadless() возвраты true.

См. Также:

GraphicsEnvironment.isHeadless()

DefaultMoveDrop

public static final Cursor DefaultMoveDrop

Значение по умолчанию Cursor использовать с операцией пересылки, указывающей, что отбрасывание в настоящий момент позволяется. null если GraphicsEnvironment.isHeadless() возвраты true.

См. Также:

GraphicsEnvironment.isHeadless()

DefaultLinkDrop

public static final Cursor DefaultLinkDrop

Значение по умолчанию Cursor использовать с работой ссылки, указывающей, что отбрасывание в настоящий момент позволяется. null если GraphicsEnvironment.isHeadless() возвраты true.

См. Также:

GraphicsEnvironment.isHeadless()

DefaultCopyNoDrop

public static final Cursor DefaultCopyNoDrop

Значение по умолчанию Cursor использовать с работой копии, указывающей, что отбрасывание в настоящий момент не позволяется. null если GraphicsEnvironment.isHeadless() возвраты true.

См. Также:

GraphicsEnvironment.isHeadless()

DefaultMoveNoDrop

public static final Cursor DefaultMoveNoDrop

Значение по умолчанию Cursor использовать с операцией пересылки, указывающей, что отбрасывание в настоящий момент не позволяется. null если GraphicsEnvironment.isHeadless() возвраты true.

См. Также:

GraphicsEnvironment.isHeadless()

DefaultLinkNoDrop

public static final Cursor DefaultLinkNoDrop

Значение по умолчанию Cursor использовать с работой ссылки, указывающей, что отбрасывание в настоящий момент не позволяется. null если GraphicsEnvironment.isHeadless() возвраты true.

См. Также:

GraphicsEnvironment.isHeadless()

Деталь конструктора

DragSource

public DragSource()
           throws HeadlessException

Создает новое DragSource.

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true

См. Также:

GraphicsEnvironment.isHeadless()

Деталь метода

getDefaultDragSource

public static DragSource getDefaultDragSource()

Добирается DragSource объект связался с базовой платформой.

Возвраты:

платформа DragSource

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true

См. Также:

GraphicsEnvironment.isHeadless()

isDragImageSupported

public static boolean isDragImageSupported()

Отчеты, перетаскивают ли Image поддержка доступна на базовой платформе.

Возвраты:

если Перетащить поддержка Изображения доступна на этой платформе

startDrag

public void startDrag(DragGestureEvent trigger,
                      Cursor dragCursor,
                      Image dragImage,
                      Point imageOffset,
                      Transferable transferable,
                      DragSourceListener dsl,
                      FlavorMap flavorMap)
               throws InvalidDnDOperationException

Запустите перетаскивание, данный DragGestureEvent это инициировало перетаскивание, начальную букву Cursor использовать, Image перетащить, смещение Image источник от горячей точки Cursor в момент триггера, Transferable подчиненные данные перетаскивания, DragSourceListener, и FlavorMap.

Параметры:

trigger - DragGestureEvent это инициировало перетаскивание

dragCursor - начальная буква Cursor поскольку это перетаскивает работу или null для обработки курсора значения по умолчанию; см., что DragSourceContext для большего количества деталей о механизме обработки курсора во время перетаскивают и отбрасывают

dragImage - изображение, чтобы перетащить или null

imageOffset - смещение Image источник от горячей точки Cursor в момент триггера

transferable - подчиненные данные перетаскивания

dsl - DragSourceListener

flavorMap - FlavorMap использовать, или null

Броски:

InvalidDnDOperationException - если система Перетаскивания и Отбрасывания неспособна инициировать перетащить работу, или если пользователь пытается запустить перетаскивание, в то время как существующее перетаскивает работу, все еще выполняется

startDrag

public void startDrag(DragGestureEvent trigger,
                      Cursor dragCursor,
                      Transferable transferable,
                      DragSourceListener dsl,
                      FlavorMap flavorMap)
               throws InvalidDnDOperationException

Запустите перетаскивание, данный DragGestureEvent это инициировало перетаскивание, начальную букву Cursor использовать, Transferable подчиненные данные перетаскивания, DragSourceListener, и FlavorMap.

Параметры:

trigger - DragGestureEvent это инициировало перетаскивание

dragCursor - начальная буква Cursor поскольку это перетаскивает работу или null для обработки курсора значения по умолчанию; см., что DragSourceContext для большего количества деталей о механизме обработки курсора во время перетаскивают и отбрасывают

transferable - подчиненные данные перетаскивания

dsl - DragSourceListener

flavorMap - FlavorMap использовать или null

Броски:

InvalidDnDOperationException - если система Перетаскивания и Отбрасывания неспособна инициировать перетащить работу, или если пользователь пытается запустить перетаскивание, в то время как существующее перетаскивает работу, все еще выполняется

startDrag

public void startDrag(DragGestureEvent trigger,
                      Cursor dragCursor,
                      Image dragImage,
                      Point dragOffset,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException

Запустите перетаскивание, данный DragGestureEvent это инициировало перетаскивание, начальную букву Cursor использовать, Image перетащить, смещение Image источник от горячей точки Cursor в момент триггера, подчиненные данные перетаскивания, и DragSourceListener.

Параметры:

trigger - DragGestureEvent это инициировало перетаскивание

dragCursor - начальная буква Cursor поскольку это перетаскивает работу или null для обработки курсора значения по умолчанию; см., что DragSourceContext для большего количества деталей о механизме обработки курсора во время перетаскивают и отбрасывают

dragImage - Image перетащить или null

dragOffset - смещение Image источник от горячей точки Cursor в момент триггера

transferable - подчиненные данные перетаскивания

dsl - DragSourceListener

Броски:

InvalidDnDOperationException - если система Перетаскивания и Отбрасывания неспособна инициировать перетащить работу, или если пользователь пытается запустить перетаскивание, в то время как существующее перетаскивает работу, все еще выполняется

startDrag

public void startDrag(DragGestureEvent trigger,
                      Cursor dragCursor,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException

Запустите перетаскивание, данный DragGestureEvent это инициировало перетаскивание, начальную букву Cursor использовать, Transferable подчиненные данные перетаскивания, и DragSourceListener.

Параметры:

trigger - DragGestureEvent это инициировало перетаскивание

dragCursor - начальная буква Cursor поскольку это перетаскивает работу или null для обработки курсора значения по умолчанию; см. DragSourceContext, который class для большего количества деталей о механизме обработки курсора во время перетаскивает и отбрасывает

transferable - подчиненные данные перетаскивания

dsl - DragSourceListener

Броски:

InvalidDnDOperationException - если система Перетаскивания и Отбрасывания неспособна инициировать перетащить работу, или если пользователь пытается запустить перетаскивание, в то время как существующее перетаскивает работу, все еще выполняется

createDragSourceContext

protected DragSourceContext createDragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp,
                                                    DragGestureEvent dgl,
                                                    Cursor dragCursor,
                                                    Image dragImage,
                                                    Point imageOffset,
                                                    Transferable t,
                                                    DragSourceListener dsl)

Создает DragSourceContext чтобы обработать ток перетаскивают работу.

Включить новое DragSourceContext подкласс, подкласс DragSource и переопределите этот метод.

Если dragImage null, никакое изображение не используется, чтобы представить перетаскивание по обратной связи для этого, перетаскивают работу, но NullPointerException не бросается.

Если dsl null, нет не перетащите исходного слушателя, регистрируется в создаваемом DragSourceContext, но NullPointerException не бросается.

Параметры:

dscp - DragSourceContextPeer поскольку это перетаскивает

dgl - DragGestureEvent это инициировало перетаскивание

dragCursor - Начальная буква Cursor поскольку это перетаскивает работу или null для обработки курсора значения по умолчанию; см. DragSourceContext, который class для большего количества деталей о механизме обработки курсора во время перетаскивает и отбрасывает

dragImage - Image перетащить или null

imageOffset - Смещение Image источник от горячей точки курсора в момент триггера

t - Подчиненные данные перетаскивания

dsl - DragSourceListener

Возвраты:

DragSourceContext

Броски:

NullPointerException - если dscp null

NullPointerException - если dgl null

NullPointerException - если dragImage не null и imageOffset null

NullPointerException - если t null

IllegalArgumentException - если Component связанный с триггерным событием null.

IllegalArgumentException - если DragSource для триггера событие null.

IllegalArgumentException - если перетащить действие для триггерного события DnDConstants.ACTION_NONE.

IllegalArgumentException - если исходные действия для DragGestureRecognizer связанный с триггерным событием равны DnDConstants.ACTION_NONE.

getFlavorMap

public FlavorMap getFlavorMap()

Этот метод возвращается FlavorMap для этого DragSource.

Возвраты:

FlavorMap для этого DragSource

createDragGestureRecognizer

public <T extends DragGestureRecognizer> T createDragGestureRecognizer(Class<T> recognizerAbstractClass,
                                                                       Component c,
                                                                       int actions,
                                                                       DragGestureListener dgl)

Создает новое DragGestureRecognizer это реализует указанный абстрактный подкласс DragGestureRecognizer, и устанавливает указанное Component и DragGestureListener на недавно создаваемом объекте.

Параметры:

recognizerAbstractClass - требуемый абстрактный тип

actions - разрешенный источник перетаскивает действия

c - Component цель

dgl - DragGestureListener уведомлять

Возвраты:

новое DragGestureRecognizer или null если Toolkit.createDragGestureRecognizer метод не имеет реализации в наличии для требуемого DragGestureRecognizer подкласс и возвраты null

createDefaultDragGestureRecognizer

public DragGestureRecognizer createDefaultDragGestureRecognizer(Component c,
                                                                int actions,
                                                                DragGestureListener dgl)

Создает новое DragGestureRecognizer это реализует подкласс краткого обзора значения по умолчанию DragGestureRecognizer для этого DragSource, и устанавливает указанное Component и DragGestureListener на недавно создаваемом объекте. Для этого DragSource значение по умолчанию MouseDragGestureRecognizer.

Параметры:

c - Component цель для устройства распознавания

actions - разрешенные исходные действия

dgl - DragGestureListener уведомлять

Возвраты:

новое DragGestureRecognizer или null если Toolkit.createDragGestureRecognizer метод не имеет реализации в наличии для требуемого DragGestureRecognizer подкласс и возвраты null

addDragSourceListener

public void addDragSourceListener(DragSourceListener dsl)

Добавляет указанное DragSourceListener к этому DragSource чтобы получить перетаскивают исходные события во время, перетаскивают операции intiated с этим DragSource. Если a null слушатель определяется, никакие меры не предпринимаются, и никакое исключение не выдается.

Параметры:

dsl - DragSourceListener добавить

С тех пор:

1.4

См. Также:

removeDragSourceListener(java.awt.dnd.DragSourceListener), getDragSourceListeners()

removeDragSourceListener

public void removeDragSourceListener(DragSourceListener dsl)

Удаляет указанное DragSourceListener от этого DragSource. Если a null слушатель определяется, никакие меры не предпринимаются, и никакое исключение не выдается. Если слушатель, определенный параметром, не был ранее добавлен к этому DragSource, никакие меры не предпринимаются, и никакое исключение не выдается.

Параметры:

dsl - DragSourceListener удалить

С тех пор:

1.4

См. Также:

addDragSourceListener(java.awt.dnd.DragSourceListener), getDragSourceListeners()

getDragSourceListeners

public DragSourceListener[] getDragSourceListeners()

Добирается весь DragSourceListeners зарегистрированный в этом DragSource.

Возвраты:

все это DragSource's DragSourceListeners или пустой массив, если никакие такие слушатели в настоящий момент не регистрируются

С тех пор:

1.4

См. Также:

addDragSourceListener(java.awt.dnd.DragSourceListener), removeDragSourceListener(java.awt.dnd.DragSourceListener)

addDragSourceMotionListener

public void addDragSourceMotionListener(DragSourceMotionListener dsml)

Добавляет указанное DragSourceMotionListener к этому DragSource чтобы получить перетаскивают события движения во время, перетаскивают операции intiated с этим DragSource. Если a null слушатель определяется, никакие меры не предпринимаются, и никакое исключение не выдается.

Параметры:

dsml - DragSourceMotionListener добавить

С тех пор:

1.4

См. Также:

removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener), getDragSourceMotionListeners()

removeDragSourceMotionListener

public void removeDragSourceMotionListener(DragSourceMotionListener dsml)

Удаляет указанное DragSourceMotionListener от этого DragSource. Если a null слушатель определяется, никакие меры не предпринимаются, и никакое исключение не выдается. Если слушатель, определенный параметром, не был ранее добавлен к этому DragSource, никакие меры не предпринимаются, и никакое исключение не выдается.

Параметры:

dsml - DragSourceMotionListener удалить

С тех пор:

1.4

См. Также:

addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener), getDragSourceMotionListeners()

getDragSourceMotionListeners

public DragSourceMotionListener[] getDragSourceMotionListeners()

Получает весь из DragSourceMotionListeners зарегистрированный в этом DragSource.

Возвраты:

все это DragSource's DragSourceMotionListeners или пустой массив, если никакие такие слушатели в настоящий момент не регистрируются

С тех пор:

1.4

См. Также:

addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener), removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Получает все объекты, в настоящий момент зарегистрированные как FooListeners на это DragSource. FooListeners регистрируются, используя addFooListener метод.

Параметры:

listenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener

Возвраты:

массив всех объектов, зарегистрированных как FooListeners на этом DragSource, или пустой массив, если никакие такие слушатели не были добавлены

Броски:

ClassCastException - если listenerType не определяет class или интерфейс, который реализует java.util.EventListener

С тех пор:

1.4

См. Также:

getDragSourceListeners(), getDragSourceMotionListeners()

getDragThreshold

public static int getDragThreshold()

Возвраты перетащить порог движения жеста. Перетащить порог движения жеста определяет рекомендуемое поведение для MouseDragGestureRecognizers.

Если системное свойство awt.dnd.drag.threshold устанавливается в положительное целое число, этот метод возвращает значение системного свойства; иначе, если подходящее настольное свойство доступно и поддерживается реализацией платформы Java, этот метод возвращает значение того свойства; иначе этот метод возвращает некоторое значение по умолчанию. Подходящее настольное свойство может быть запрошено, используя java.awt.Toolkit.getDesktopProperty("DnD.gestureMotionThreshold").

Возвраты:

перетащить порог движения жеста

С тех пор:

1.5

См. Также:

MouseDragGestureRecognizer