DragSourceContext (Платформа Java SE 7)

java.lang. Объект
- java.awt.dnd. DragSourceContext

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

DragSourceListener, DragSourceMotionListener, Сериализуемый, EventListener
```
public class DragSourceContext
extends Object
implements DragSourceListener, DragSourceMotionListener, Serializable
```
DragSourceContext класс ответственен за управление стороной инициатора протокола Перетаскивания и Отбрасывания. В частности это ответственно за управление, перетаскивают уведомления о событии в DragSourceListeners и DragSourceMotionListeners, и обеспечение Transferable представление исходных данных для перетащить работы.
Отметьте что DragSourceContext непосредственно реализации DragSourceListener и DragSourceMotionListener интерфейсы. Это должно позволить коллегу платформы ( DragSourceContextPeer экземпляр) создаваемый DragSource уведомлять DragSourceContext из изменений состояния в продолжающейся операции. Это позволяет DragSourceContext объект вставить себя между платформой и слушателями, предоставленными инициатором перетащить работы.
По умолчанию, DragSourceContext устанавливает курсор как соответствующий для текущего состояния работы перетаскивания и отбрасывания. Например, если пользователь выбрал действие перемещения, и указатель по цели, которая принимает действие перемещения, курсор перемещения по умолчанию показывают. Когда указатель по области, которая не принимает передачу, значение по умолчанию "никакое отбрасывание" курсор показывают.
Этот механизм обработки значения по умолчанию отключается, когда пользовательский курсор устанавливается setCursor(java.awt.Cursor) метод. Когда обработка по умолчанию отключается, это становится обязанностью разработчика усовершенствовать курсор, слушая DragSource события и вызов setCursor() метод. Альтернативно, можно обеспечить пользовательское поведение курсора, обеспечивая пользовательские реализации DragSource и DragSourceContext классы.

С тех пор:

1.2

См. Также:
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)` Если значение по умолчанию перетаскивает поведение курсора, является активным, эти наборы метода, значение по умолчанию перетаскивает курсор для указанных действий, поддерживаемых перетащить источником, целевым действием отбрасывания, и состоянием, иначе этот метод ничего не делает.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - ЗНАЧЕНИЕ ПО УМОЛЧАНИЮ
```
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 () указание, что пользовательская работа изменилась.
  
  См. Также:
  Постоянные Значения полей
- Деталь конструктора
  - DragSourceContext
```
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 для обработки курсора по умолчанию; см., что документация уровня класса для большего количества деталей о механизме обработки курсора во время перетаскивает и отбрасывает
    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 является ненулем, и смещение является нулем
- Деталь метода
  - getDragSource
```
public DragSource getDragSource()
```
    Возвраты DragSource это инстанцировало этого DragSourceContext.
    
    Возвраты:
    DragSource это инстанцировало этого DragSourceContext
  - getComponent
```
public Component getComponent()
```
    Возвраты Component связанный с этим DragSourceContext.
    
    Возвраты:
    Component это запустило перетаскивание
  - getTrigger
```
public DragGestureEvent getTrigger()
```
    Возвраты DragGestureEvent это первоначально инициировало перетаскивание.
    
    Возвраты:
    Событие, которое инициировало перетаскивание
  - getSourceActions
```
public int getSourceActions()
```
    Возвращает поразрядную маску DnDConstants это представляет набор действий отбрасывания, поддерживаемых перетащить источником для перетащить работы, связанной с этим DragSourceContext.
    
    Возвраты:
    действия отбрасывания, поддерживаемые перетащить источником
  - setCursor
```
public void setCursor(Cursor c)
```
    Устанавливает курсор для этого, перетаскивают работу к указанному Cursor. Если указанное Cursor null, значение по умолчанию перетаскивает поведение курсора, активируется для этого, перетаскивают работу, иначе это деактивировано.
    
    Параметры:
    c - начальная буква Cursor поскольку это перетаскивает работу, или null для обработки курсора по умолчанию; см., что документация уровня класса для большего количества деталей об обработке курсора во время перетаскивает и отбрасывает
  - getCursor
```
public Cursor getCursor()
```
    Возвращается ток перетаскивают Cursor.
    
    Возвраты:
    ток перетаскивает Cursor
  - addDragSourceListener
```
public void addDragSourceListener(DragSourceListener dsl)
                           throws TooManyListenersException
```
    Добавьте a DragSourceListener к этому DragSourceContext если Вы не были уже добавлены. Если a DragSourceListener уже существует, этот метод бросает a TooManyListenersException.
    
    Параметры:
    dsl - DragSourceListener добавить. Отметьте это в то время как null не запрещается, это не приемлемо в качестве параметра.
    
    Броски:
    
    TooManyListenersException - если a DragSourceListener был уже добавлен
  - removeDragSourceListener
```
public void removeDragSourceListener(DragSourceListener dsl)
```
    Удаляет указанное DragSourceListener от этого DragSourceContext.
    
    Параметры:
    dsl - DragSourceListener удалить; отметьте это в то время как null не запрещается, это не приемлемо в качестве параметра
  - transferablesFlavorsChanged
```
public void transferablesFlavorsChanged()
```
    Уведомляет коллегу что Transferable's DataFlavors изменились.
  - dragEnter
```
public void dragEnter(DragSourceDragEvent dsde)
```
    Вызовы dragEnter на DragSourceListeners зарегистрированный в этом DragSourceContext и со связанным DragSource, и передает их указанное DragSourceDragEvent.
    
    Определенный:
    
    dragEnter в интерфейсе DragSourceListener
    
    Параметры:
    dsde - DragSourceDragEvent
  - dragOver
```
public void dragOver(DragSourceDragEvent dsde)
```
    Вызовы dragOver на DragSourceListeners зарегистрированный в этом DragSourceContext и со связанным DragSource, и передает их указанное DragSourceDragEvent.
    
    Определенный:
    
    dragOver в интерфейсе DragSourceListener
    
    Параметры:
    dsde - DragSourceDragEvent
  - dragExit
```
public void dragExit(DragSourceEvent dse)
```
    Вызовы dragExit на DragSourceListeners зарегистрированный в этом DragSourceContext и со связанным DragSource, и передает их указанное DragSourceEvent.
    
    Определенный:
    
    dragExit в интерфейсе DragSourceListener
    
    Параметры:
    dse - DragSourceEvent
  - dropActionChanged
```
public void dropActionChanged(DragSourceDragEvent dsde)
```
    Вызовы dropActionChanged на DragSourceListeners зарегистрированный в этом DragSourceContext и со связанным DragSource, и передает их указанное DragSourceDragEvent.
    
    Определенный:
    
    dropActionChanged в интерфейсе DragSourceListener
    
    Параметры:
    dsde - DragSourceDragEvent
  - dragDropEnd
```
public void dragDropEnd(DragSourceDropEvent dsde)
```
    Вызовы dragDropEnd на DragSourceListeners зарегистрированный в этом DragSourceContext и со связанным DragSource, и передает их указанное DragSourceDropEvent.
    
    Определенный:
    
    dragDropEnd в интерфейсе DragSourceListener
    
    Параметры:
    dsde - DragSourceDropEvent
  - dragMouseMoved
```
public void dragMouseMoved(DragSourceDragEvent dsde)
```
    Вызовы dragMouseMoved на DragSourceMotionListeners зарегистрированный в DragSource связанный с этим DragSourceContext, и их передает указанное DragSourceDragEvent.
    
    Определенный:
    
    dragMouseMoved в интерфейсе DragSourceMotionListener
    
    Параметры:
    dsde - DragSourceDragEvent
    С тех пор:
    
    1.4
  - getTransferable
```
public Transferable getTransferable()
```
    Возвраты Transferable связанный с этим DragSourceContext.
    
    Возвраты:
    Transferable
  - updateCurrentCursor
```
protected void updateCurrentCursor(int sourceAct,
                       int targetAct,
                       int status)
```
    Если значение по умолчанию перетаскивает поведение курсора, является активным, эти наборы метода, значение по умолчанию перетаскивает курсор для указанных действий, поддерживаемых перетащить источником, целевым действием отбрасывания, и состоянием, иначе этот метод ничего не делает.
    
    Параметры:
    sourceAct - действия, поддерживаемые перетащить источником
    targetAct - целевое действие отбрасывания
    status - одно из полей DEFAULT, ENTER, OVER, CHANGED

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс DragSourceContext

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

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

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

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

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

ЗНАЧЕНИЕ ПО УМОЛЧАНИЮ

ВОЙТИ

ИЗМЕНЕННЫЙ

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

DragSourceContext

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

getDragSource

getComponent

getTrigger

getSourceActions

setCursor

getCursor

addDragSourceListener

removeDragSourceListener

transferablesFlavorsChanged

dragEnter

dragOver

dragExit

dropActionChanged

dragDropEnd

dragMouseMoved

getTransferable

updateCurrentCursor