DragSourceContext (Java Platform SE 8 )

java.lang.Object
- java.awt.dnd.DragSourceContext

All Implemented Interfaces:

DragSourceListener， DragSourceMotionListener， Serializable， EventListener
```
public class DragSourceContext
extends Object
implements DragSourceListener, DragSourceMotionListener, Serializable
```
的 DragSourceContext类负责管理引发一侧的拖放协议。特别是，它是负责管理的拖动事件通知给 DragSourceListeners和 DragSourceMotionListeners，并提供代表拖动操作的源数据 Transferable。
请注意，DragSourceContext本身实现了DragSourceListener和DragSourceMotionListener接口。这是为了让平台的同行（的DragSourceContextPeer实例）的DragSource创建通知在正在进行的操作状态的变化DragSourceContext。这让DragSourceContext干预对象的拖动操作发起者提供平台与听众之间。

默认情况下，DragSourceContext设置光标为适合当前状态的拖放操作。例如，如果用户选择了the move action，和指针在目标接受移动动作，默认是显示移动光标。当指针位于不接受传输的区域时，默认的“不降”光标显示。

此默认处理机制时禁用自定义光标是由setCursor(java.awt.Cursor)方法。当默认处理是残疾人，成为开发商的责任让光标到目前为止，通过听DragSource事件并调用setCursor()方法。或者，你可以通过提供的DragSource自定义实现，DragSourceContext类提供自定义光标的行为。

从以下版本开始：

一点二

另请参见：

DragSourceListener， DragSourceMotionListener， DnDConstants， Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected static int`	`CHANGED` 一个由updatecurrentcursor()表明用户的操作改变了用 `int`。
`protected static int`	`DEFAULT` 一个由updatecurrentcursor()表明 `Cursor`应该更改为默认使用 `int`（没有下降） `Cursor`。
`protected static int`	`ENTER` 一个由updatecurrentcursor()表明 `Cursor`进入 `DropTarget`用 `int`。
`protected static int`	`OVER` 一个由updatecurrentcursor()表明 `Cursor`在 `DropTarget`用 `int`。

构造方法摘要

构造方法
Constructor and Description
`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`中使用拖放操作。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`addDragSourceListener(DragSourceListener dsl)` 添加一个 `DragSourceListener`这 `DragSourceContext`如果尚未添加。
`void`	`dragDropEnd(DragSourceDropEvent dsde)` 呼吁 `DragSourceListener`s注册这个 `DragSourceContext`和与相关的 `DragSource` `dragDropEnd`，并通过他们指定的 `DragSourceDropEvent`。
`void`	`dragEnter(DragSourceDragEvent dsde)` 呼吁 `DragSourceListener`s注册这个 `DragSourceContext`和与相关的 `DragSource` `dragEnter`，并通过他们指定的 `DragSourceDragEvent`。
`void`	`dragExit(DragSourceEvent dse)` 呼吁 `DragSourceListener`s注册这个 `DragSourceContext`和与相关的 `DragSource` `dragExit`，并通过他们指定的 `DragSourceEvent`。
`void`	`dragMouseMoved(DragSourceDragEvent dsde)` 呼吁这个 `DragSourceContext`相关的 `DragSource`注册 `DragSourceMotionListener`s `dragMouseMoved`，并通过指定的 `DragSourceDragEvent`。
`void`	`dragOver(DragSourceDragEvent dsde)` 呼吁 `DragSourceListener`s注册这个 `DragSourceContext`和与相关的 `DragSource` `dragOver`，并通过他们指定的 `DragSourceDragEvent`。
`void`	`dropActionChanged(DragSourceDragEvent dsde)` 呼吁 `DragSourceListener`s注册这个 `DragSourceContext`和与相关的 `DragSource` `dropActionChanged`，并通过他们指定的 `DragSourceDragEvent`。
`Component`	`getComponent()` 返回与此相关的 `Component` `DragSourceContext`。
`Cursor`	`getCursor()` 返回当前的阻力 `Cursor`。
`DragSource`	`getDragSource()` 返回 `DragSource`实例化这个 `DragSourceContext`。
`int`	`getSourceActions()` 返回 `DnDConstants`表示下降的行动与此相关的 `DragSourceContext`拖动操作拖放源支持设置的位掩码。
`Transferable`	`getTransferable()` 返回与此相关的 `Transferable` `DragSourceContext`。
`DragGestureEvent`	`getTrigger()` 返回最初触发拖动 `DragGestureEvent`。
`void`	`removeDragSourceListener(DragSourceListener dsl)` 从这个 `DragSourceContext`移除指定的 `DragSourceListener`。
`void`	`setCursor(Cursor c)` 设置指定的 `Cursor`这个拖动操作光标。
`void`	`transferablesFlavorsChanged()` 通知同伴， `Transferable`的 `DataFlavor`s已经改变。
`protected void`	`updateCurrentCursor(int sourceAct, int targetAct, int status)` 如果默认的拖动光标行为是主动的，该方法将默认的拖动光标设置为支持的指定操作的默认拖动光标，拖放目标动作和状态，否则这种方法将不做任何操作。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT
```
protected static final int DEFAULT
```
    一个由updatecurrentcursor()表明 Cursor应该更改为默认使用 int（没有下降） Cursor。
    
    另请参见：
    
    Constant Field Values
  - ENTER
```
protected static final int ENTER
```
    一个由updatecurrentcursor()表明 Cursor进入 DropTarget用 int。
    
    另请参见：
    
    Constant Field Values
  - OVER
```
protected static final int OVER
```
    一个由updatecurrentcursor()表明 Cursor在 DropTarget用 int。
    
    另请参见：
    
    Constant Field Values
  - CHANGED
```
protected static final int CHANGED
```
    一个由updatecurrentcursor()表明用户的操作改变了用 int。
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - 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为默认光标处理这个拖动操作或 null初始 Cursor；见的鼠标拖放在处理机制的更多细节 class level documentation
    
    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，触发，或是零，或者如果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为默认光标处理；看到在光标拖放操作期间的更多细节 class level documentation
  - getCursor
```
public Cursor getCursor()
```
    返回当前 Cursor
    拖动。
    
    结果
    
    目前的阻力 Cursor
  - addDragSourceListener
```
public void addDragSourceListener(DragSourceListener dsl)
                           throws TooManyListenersException
```
    添加一个 DragSourceListener这 DragSourceContext如果尚未添加。如果一个 DragSourceListener已经存在，该方法抛出一个 TooManyListenersException。
    
    参数
    
    dsl - DragSourceListener添加。值得注意的是，虽然 null是不禁止的，这是不可接受的参数。
    
    异常
    
    TooManyListenersException -如果一个 DragSourceListener已添加
  - removeDragSourceListener
```
public void removeDragSourceListener(DragSourceListener dsl)
```
    从这个 DragSourceContext移除指定的 DragSourceListener。
    
    参数
    
    dsl - DragSourceListener去除；注意，而 null是不禁止的，这是不可接受的参数
  - transferablesFlavorsChanged
```
public void transferablesFlavorsChanged()
```
    通知同伴， Transferable的 DataFlavors已经改变。
  - dragEnter
```
public void dragEnter(DragSourceDragEvent dsde)
```
    呼吁 DragSourceListeners注册这个 DragSourceContext和与相关的 DragSource dragEnter，并通过他们指定的 DragSourceDragEvent。
    
    Specified by:
    
    dragEnter 接口 DragSourceListener
    
    参数
    
    dsde - DragSourceDragEvent
  - dragOver
```
public void dragOver(DragSourceDragEvent dsde)
```
    呼吁 DragSourceListeners注册这个 DragSourceContext和与相关的 DragSource dragOver，并通过他们指定的 DragSourceDragEvent。
    
    Specified by:
    
    dragOver 接口 DragSourceListener
    
    参数
    
    dsde - DragSourceDragEvent
  - dragExit
```
public void dragExit(DragSourceEvent dse)
```
    呼吁 DragSourceListeners注册这个 DragSourceContext和与相关的 DragSource dragExit，并通过他们指定的 DragSourceEvent。
    
    Specified by:
    
    dragExit 接口 DragSourceListener
    
    参数
    
    dse - DragSourceEvent
  - dropActionChanged
```
public void dropActionChanged(DragSourceDragEvent dsde)
```
    呼吁 DragSourceListeners注册这个 DragSourceContext和与相关的 DragSource dropActionChanged，并通过他们指定的 DragSourceDragEvent。
    
    Specified by:
    
    dropActionChanged 接口 DragSourceListener
    
    参数
    
    dsde - DragSourceDragEvent
  - dragDropEnd
```
public void dragDropEnd(DragSourceDropEvent dsde)
```
    呼吁 DragSourceListeners注册这个 DragSourceContext和与相关的 DragSource dragDropEnd，并通过他们指定的 DragSourceDropEvent。
    
    Specified by:
    
    dragDropEnd 接口 DragSourceListener
    
    参数
    
    dsde - DragSourceDropEvent
  - dragMouseMoved
```
public void dragMouseMoved(DragSourceDragEvent dsde)
```
    呼吁这个 DragSourceContext相关的 DragSource注册 DragSourceMotionListeners dragMouseMoved，并通过指定的 DragSourceDragEvent。
    
    Specified by:
    
    dragMouseMoved 接口 DragSourceMotionListener
    
    参数
    
    dsde - DragSourceDragEvent
    
    从以下版本开始：
    
    一点四
  - getTransferable
```
public Transferable getTransferable()
```
    返回与此相关的 Transferable DragSourceContext。
    
    结果
    
    的 Transferable
  - updateCurrentCursor
```
protected void updateCurrentCursor(int sourceAct,
                                   int targetAct,
                                   int status)
```
    如果默认的拖动光标行为是主动的，该方法将默认的拖动光标设置为支持的指定操作的默认拖动光标，拖放目标动作和状态，否则这种方法将不做任何操作。
    
    参数
    
    sourceAct通过拖动源支持行动
    
    targetAct -降低目标的行动
    
    status -一个领域 DEFAULT， ENTER， OVER， CHANGED

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class DragSourceContext

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

DEFAULT

ENTER

OVER

CHANGED

Constructor Detail

DragSourceContext

方法详细信息

getDragSource

getComponent

getTrigger

getSourceActions

setCursor

getCursor

addDragSourceListener

removeDragSourceListener

transferablesFlavorsChanged

dragEnter

dragOver

dragExit

dropActionChanged

dragDropEnd

dragMouseMoved

getTransferable

updateCurrentCursor