Spec-Zone .ru
спецификации, руководства, описания, API
|
public class DragSourceContext extends Object implements DragSourceListener, DragSourceMotionListener, Serializable
DragSourceContext
class ответственен за управление стороной инициатора протокола Перетаскивания и Отбрасывания. В частности это ответственно за управление, перетаскивают уведомления о событии в DragSourceListeners и DragSourceMotionListeners, и обеспечение Transferable
представление исходных данных для перетащить работы. Отметьте что DragSourceContext
непосредственно реализации DragSourceListener
и DragSourceMotionListener
интерфейсы. Это должно позволить коллегу платформы (<код> DragSourceContextPeer </код> экземпляр) создаваемый DragSource
уведомлять DragSourceContext
из изменений состояния в продолжающейся операции. Это позволяет DragSourceContext
объект вставить себя между платформой и слушателями, предоставленными инициатором перетащить работы.
По умолчанию, DragSourceContext
устанавливает курсор как соответствующий для текущего состояния работы перетаскивания и отбрасывания. Например, если пользователь выбрал действие перемещения, и указатель по цели, которая принимает действие перемещения, курсор перемещения значения по умолчанию показывают. Когда указатель по области, которая не принимает передачу, значение по умолчанию "никакое отбрасывание" курсор показывают.
Этот механизм обработки значения по умолчанию отключается, когда пользовательский курсор устанавливается setCursor(java.awt.Cursor)
метод. Когда обработка значения по умолчанию отключается, это становится обязанностью разработчика усовершенствовать курсор, слушая DragSource
события и вызов setCursor()
метод. Альтернативно, можно обеспечить пользовательское поведение курсора, обеспечивая пользовательские реализации DragSource
и DragSourceContext
классы.
DragSourceListener
, DragSourceMotionListener
, DnDConstants
, Сериализированная ФормаМодификатор и Тип | Поле и Описание |
---|---|
protected static int |
ИЗМЕНЕННЫЙ
int используемый updateCurrentCursor () указание, что пользовательская работа изменилась. |
protected static int |
ЗНАЧЕНИЕ ПО УМОЛЧАНИЮ
int используемый updateCurrentCursor () указание, что Cursor должен измениться на значение по умолчанию (никакое отбрасывание) Cursor . |
protected static int |
ВОЙТИ
int используемый updateCurrentCursor () указание, что Cursor ввел a DropTarget . |
protected static int |
int используемый updateCurrentCursor () указание, что Cursor по a DropTarget . |
Конструктор и Описание |
---|
DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point offset, Transferable t, DragSourceListener dsl)
Вызванный от
DragSource , этот конструктор создает новое DragSourceContext данный DragSourceContextPeer поскольку это Перетаскивает, DragGestureEvent это инициировало Перетаскивание, начальную букву Cursor использовать для Перетаскивания, (дополнительный) Image вывести на экран, в то время как Перетаскивание имеет место, смещение Image источник от горячей точки в момент инициирующего события, Transferable подчиненные данные, и DragSourceListener использовать во время работы Перетаскивания и Отбрасывания. |
Модификатор и Тип | Метод и Описание |
---|---|
void |
addDragSourceListener(DragSourceListener dsl)
Добавьте a
DragSourceListener к этому DragSourceContext если Вы не были уже добавлены. |
void |
dragDropEnd(DragSourceDropEvent dsde)
Вызовы
dragDropEnd на DragSourceListener s зарегистрированный в этом DragSourceContext и со связанным DragSource , и передает их указанное DragSourceDropEvent . |
void |
dragEnter(DragSourceDragEvent dsde)
Вызовы
dragEnter на DragSourceListener s зарегистрированный в этом DragSourceContext и со связанным DragSource , и передает их указанное DragSourceDragEvent . |
void |
dragExit(DragSourceEvent dse)
Вызовы
dragExit на DragSourceListener s зарегистрированный в этом DragSourceContext и со связанным DragSource , и передает их указанное DragSourceEvent . |
void |
dragMouseMoved(DragSourceDragEvent dsde)
Вызовы
dragMouseMoved на DragSourceMotionListener s зарегистрированный в DragSource связанный с этим DragSourceContext , и их передает указанное DragSourceDragEvent . |
void |
dragOver(DragSourceDragEvent dsde)
Вызовы
dragOver на DragSourceListener s зарегистрированный в этом DragSourceContext и со связанным DragSource , и передает их указанное DragSourceDragEvent . |
void |
dropActionChanged(DragSourceDragEvent dsde)
Вызовы
dropActionChanged на DragSourceListener s зарегистрированный в этом DragSourceContext и со связанным DragSource , и передает их указанное DragSourceDragEvent . |
Компонент |
getComponent()
Возвраты
Component связанный с этим DragSourceContext . |
Курсор |
getCursor()
Возвращается ток перетаскивают
Cursor . |
DragSource |
getDragSource()
Возвраты
DragSource это инстанцировало этого DragSourceContext . |
int |
getSourceActions()
Возвращает поразрядную маску
DnDConstants это представляет набор действий отбрасывания, поддерживаемых перетащить источником для перетащить работы, связанной с этим DragSourceContext . |
Передаваемый |
getTransferable()
Возвраты
Transferable связанный с этим DragSourceContext . |
DragGestureEvent |
getTrigger()
Возвраты
DragGestureEvent это первоначально инициировало перетаскивание. |
void |
removeDragSourceListener(DragSourceListener dsl)
Удаляет указанное
DragSourceListener от этого DragSourceContext . |
void |
setCursor(Cursor c)
Устанавливает курсор для этого, перетаскивают работу к указанному
Cursor . |
void |
transferablesFlavorsChanged()
Уведомляет коллегу что
Transferable 's DataFlavor s изменились. |
protected void |
updateCurrentCursor(int sourceAct, int targetAct, int status)
Если значение по умолчанию перетаскивает поведение курсора, является активным, эти наборы метода, значение по умолчанию перетаскивает курсор для указанных действий, поддерживаемых перетащить источником, целевым действием отбрасывания, и состоянием, иначе этот метод ничего не делает.
|
protected static final int DEFAULT
int
используемый updateCurrentCursor () указание, что Cursor
должен измениться на значение по умолчанию (никакое отбрасывание) Cursor
.protected static final int ENTER
int
используемый updateCurrentCursor () указание, что Cursor
ввел a DropTarget
.protected static final int OVER
int
используемый updateCurrentCursor () указание, что Cursor
по a DropTarget
.protected static final int CHANGED
int
используемый updateCurrentCursor () указание, что пользовательская работа изменилась.public DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point offset, Transferable t, DragSourceListener dsl)
DragSource
, этот конструктор создает новое DragSourceContext
данный DragSourceContextPeer
поскольку это Перетаскивает, DragGestureEvent
это инициировало Перетаскивание, начальную букву Cursor
использовать для Перетаскивания, (дополнительный) Image
вывести на экран, в то время как Перетаскивание имеет место, смещение Image
источник от горячей точки в момент инициирующего события, Transferable
подчиненные данные, и DragSourceListener
использовать во время работы Перетаскивания и Отбрасывания. DragSourceContextPeer
null
NullPointerException
бросается. DragGestureEvent
null
NullPointerException
бросается. Cursor
null
никакое исключение не выдается, и значение по умолчанию перетаскивают поведение курсора, активируется для этого, перетаскивают работу. Image
null
никакое исключение не выдается. Image
не null
и смещение null
NullPointerException
бросается. Transferable
null
NullPointerException
бросается. DragSourceListener
null
никакое исключение не выдается.dscp
- DragSourceContextPeer
поскольку это перетаскиваетtrigger
- инициирующее событиеdragCursor
- начальная буква Cursor
поскольку это перетаскивает работу или null
для обработки курсора значения по умолчанию; см., что документация уровня class для большего количества деталей о механизме обработки курсора во время перетаскивает и отбрасываетdragImage
- Image
перетащить (или null
)offset
- смещение источника изображения от горячей точки в момент инициирующего событияt
- Transferable
dsl
- DragSourceListener
IllegalArgumentException
- если Component
связанный с триггерным событием null
.IllegalArgumentException
- если DragSource
для триггера событие null
.IllegalArgumentException
- если перетащить действие для триггерного события DnDConstants.ACTION_NONE
.IllegalArgumentException
- если исходные действия для DragGestureRecognizer
связанный с триггерным событием равны DnDConstants.ACTION_NONE
.NullPointerException
- если dscp, триггер, или t являются нулем, или если dragImage является ненулем, и смещение является нулемpublic DragSource getDragSource()
DragSource
это инстанцировало этого DragSourceContext
.DragSource
это инстанцировало этого DragSourceContext
public Component getComponent()
Component
связанный с этим DragSourceContext
.Component
это запустило перетаскиваниеpublic DragGestureEvent getTrigger()
DragGestureEvent
это первоначально инициировало перетаскивание.public int getSourceActions()
DnDConstants
это представляет набор действий отбрасывания, поддерживаемых перетащить источником для перетащить работы, связанной с этим DragSourceContext
.public void setCursor(Cursor c)
Cursor
. Если указанное Cursor
null
, значение по умолчанию перетаскивает поведение курсора, активируется для этого, перетаскивают работу, иначе это деактивировано.c
- начальная буква Cursor
поскольку это перетаскивает работу, или null
для обработки курсора значения по умолчанию; см., что документация уровня class для большего количества деталей об обработке курсора во время перетаскивает и отбрасываетpublic Cursor getCursor()
Cursor
. Cursor
public void addDragSourceListener(DragSourceListener dsl) throws TooManyListenersException
DragSourceListener
к этому DragSourceContext
если Вы не были уже добавлены. Если a DragSourceListener
уже существует, этот метод бросает a TooManyListenersException
. dsl
- DragSourceListener
добавить. Отметьте это в то время как null
не запрещается, это не приемлемо в качестве параметра. TooManyListenersException
- если a DragSourceListener
был уже добавленpublic void removeDragSourceListener(DragSourceListener dsl)
DragSourceListener
от этого DragSourceContext
.dsl
- DragSourceListener
удалить; отметьте это в то время как null
не запрещается, это не приемлемо в качестве параметраpublic void transferablesFlavorsChanged()
Transferable
's DataFlavor
s изменились.public void dragEnter(DragSourceDragEvent dsde)
dragEnter
на DragSourceListener
s зарегистрированный в этом DragSourceContext
и со связанным DragSource
, и передает их указанное DragSourceDragEvent
.dragEnter
в интерфейсе DragSourceListener
dsde
- DragSourceDragEvent
public void dragOver(DragSourceDragEvent dsde)
dragOver
на DragSourceListener
s зарегистрированный в этом DragSourceContext
и со связанным DragSource
, и передает их указанное DragSourceDragEvent
.dragOver
в интерфейсе DragSourceListener
dsde
- DragSourceDragEvent
public void dragExit(DragSourceEvent dse)
dragExit
на DragSourceListener
s зарегистрированный в этом DragSourceContext
и со связанным DragSource
, и передает их указанное DragSourceEvent
.dragExit
в интерфейсе DragSourceListener
dse
- DragSourceEvent
public void dropActionChanged(DragSourceDragEvent dsde)
dropActionChanged
на DragSourceListener
s зарегистрированный в этом DragSourceContext
и со связанным DragSource
, и передает их указанное DragSourceDragEvent
.dropActionChanged
в интерфейсе DragSourceListener
dsde
- DragSourceDragEvent
public void dragDropEnd(DragSourceDropEvent dsde)
dragDropEnd
на DragSourceListener
s зарегистрированный в этом DragSourceContext
и со связанным DragSource
, и передает их указанное DragSourceDropEvent
.dragDropEnd
в интерфейсе DragSourceListener
dsde
- DragSourceDropEvent
public void dragMouseMoved(DragSourceDragEvent dsde)
dragMouseMoved
на DragSourceMotionListener
s зарегистрированный в DragSource
связанный с этим DragSourceContext
, и их передает указанное DragSourceDragEvent
.dragMouseMoved
в интерфейсе DragSourceMotionListener
dsde
- DragSourceDragEvent
public Transferable getTransferable()
Transferable
связанный с этим DragSourceContext
.Transferable
protected void updateCurrentCursor(int sourceAct, int targetAct, int status)
sourceAct
- действия, поддерживаемые перетащить источникомtargetAct
- целевое действие отбрасыванияstatus
- одно из полей DEFAULT
, ENTER
, OVER
, CHANGED
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92