java.awt.dnd
类 DragSourceContext

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

所有已实现的接口：

DragSourceListener, DragSourceMotionListener, Serializable, EventListener

public class DragSourceContext
extends Object
implements DragSourceListener, DragSourceMotionListener, Serializable

DragSourceContext 类负责管理 Drag 和 Drop 协议的起始端。特别是负责管理对 DragSourceListener 和 DragSourceMotionListener 的拖动事件通知，并提供表示拖动操作源数据的 Transferable。

注意，DragSourceContext 自行实现 DragSourceListener 和 DragSourceMotionListener 接口。这就允许 DragSource 创建的平台同位体（DragSourceContextPeer 实例）能够在正在进行的操作中通知 DragSourceContext 状态改变。从而允许 DragSourceContext 介入平台和拖动操作起始端所提供的侦听器之间。

从以下版本开始：

1.2

另请参见：

DragSourceListener, DragSourceMotionListener, 序列化表格

字段摘要

protected static int	CHANGED updateCurrentCursor() 使用的 int 值，指示用户操作已改变。
protected static int	DEFAULT updateCurrentCursor() 使用的 int 值，指示应该将 Cursor 改为默认（未放置）的 Cursor。
protected static int	ENTER updateCurrentCursor() 使用的 int 值，指示 Cursor 已进入 DropTarget。
protected static int	OVER updateCurrentCursor() 使用的 int 值，指示 Cursor 处于 DropTarget 上。

构造方法摘要

DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point offset, Transferable t, DragSourceListener dsl)
从 DragSource 调用，此构造方法创建一个新 DragSourceContext，使其具有为此 Drag 指定的 DragSourceContextPeer、触发该 Drag 的 DragGestureEvent、用于该 Drag 的初始 Cursor、进行 Drag 时显示的 Image（可选）、Image 原点与触发事件时距离热点的偏移量、Transferable 目标数据、Drag 和 Drop 操作期间使用的 DragSourceListener。

方法摘要

void	addDragSourceListener(DragSourceListener dsl) 如果尚未将 DragSourceListener 添加到此 DragSourceContext，则添加一个。
void	dragDropEnd(DragSourceDropEvent dsde) 对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener 调用 dragDropEnd，并将指定的 DragSourceDropEvent 传递给它们。
void	dragEnter(DragSourceDragEvent dsde) 对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener 调用 dragEnter，并将指定的 DragSourceDragEvent 传递给它们。
void	dragExit(DragSourceEvent dse) 对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener 调用 dragExit，并将指定的 DragSourceEvent 传递给它们。
void	dragMouseMoved(DragSourceDragEvent dsde) 对向与此 DragSourceContext 关联的 DragSource 注册的 DragSourceMotionListener 调用 dragMouseMoved，并将指定的 DragSourceDragEvent 传递给它们。
void	dragOver(DragSourceDragEvent dsde) 对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceContext 调用 dragOver，并将指定的 DragSourceDragEvent 传递给它们。
void	dropActionChanged(DragSourceDragEvent dsde) 对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener 调用 dropActionChanged，并将指定的 DragSourceDragEvent 传递给它们。
Component	getComponent() 返回与此 DragSourceContext 关联的 Component。
Cursor	getCursor() 返回当前的拖动 Cursor
DragSource	getDragSource() 返回实例化此 DragSourceContext 的 DragSource。
int	getSourceActions() 返回 DnDConstants 的位掩码，表示拖动源针对与此 DragSourceContext 关联的拖动操作所支持的放置动作集合。
Transferable	getTransferable() 返回与此 DragSourceContext 关联的 Transferable。
DragGestureEvent	getTrigger() 返回最初触发该拖动的 DragGestureEvent。
void	removeDragSourceListener(DragSourceListener dsl) 从此 DragSourceContext 移除指定的 DragSourceListener。
void	setCursor(Cursor c) 将此拖动操作的光标设置为指定的 Cursor。
void	transferablesFlavorsChanged() 通知同位体该 Transferable 的 DataFlavor 已改变。
protected void	updateCurrentCursor(int sourceAct, int targetAct, int status) 如果默认拖动光标行为处于活动状态，则此方法将为默认拖动光标设置受拖动源、放置目标动作和状态支持的指定动作，否则此方法不执行任何操作。

从类 java.lang.Object 继承的方法

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

字段详细信息

DEFAULT

protected static final int DEFAULT

updateCurrentCursor() 使用的 int 值，指示应该将 Cursor 改为默认（未放置）的 Cursor。

另请参见：

常量字段值

ENTER

protected static final int ENTER

updateCurrentCursor() 使用的 int 值，指示 Cursor 已进入 DropTarget。

另请参见：

常量字段值

OVER

protected static final int OVER

updateCurrentCursor() 使用的 int 值，指示 Cursor 处于 DropTarget 上。

另请参见：

常量字段值

CHANGED

protected static final int CHANGED

updateCurrentCursor() 使用的 int 值，指示用户操作已改变。

另请参见：

常量字段值

构造方法详细信息

DragSourceContext

public DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp,
                         DragGestureEvent trigger,
                         Cursor dragCursor,
                         Image dragImage,
                         Point offset,
                         Transferable t,
                         DragSourceListener dsl)

从 DragSource 调用，此构造方法创建一个新 DragSourceContext，使其具有为此 Drag 指定的 DragSourceContextPeer、触发该 Drag 的 DragGestureEvent、用于该 Drag 的初始 Cursor、进行 Drag 时显示的 Image（可选）、Image 原点与触发事件时距离热点的偏移量、Transferable 目标数据、Drag 和 Drop 操作期间使用的 DragSourceListener。
如果 DragSourceContextPeer 为 null，则抛出 NullPointerException。
如果 DragGestureEvent 为 null，则抛出 NullPointerException。
如果 Cursor 为 null，不抛出任何异常，并为此次拖动操作激活默认的拖动光标行为。
如果 Image 为 null，不抛出任何异常。
如果 Image 不为 null 且 offset 为 null，则抛出 NullPointerException。
如果 Transferable 为 null，则抛出 NullPointerException。
如果 DragSourceListener 为 null，不抛出任何异常。

参数：

dscp - 此 Drag 的 DragSourceContextPeer

trigger - 触发事件

dragCursor - 初始的 Cursor

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、trigger 或 t 为 null，或者 dragImage 为非 null 且 offset 为 null

方法详细信息

getDragSource

public DragSource getDragSource()

返回实例化此 DragSourceContext 的 DragSource。

返回：

实例化此 DragSourceContext 的 DragSource

getComponent

public Component getComponent()

返回与此 DragSourceContext 关联的 Component。

返回：

启动拖动的 Component

getTrigger

public DragGestureEvent getTrigger()

返回最初触发该拖动的 DragGestureEvent。

返回：

触发拖动的 Event

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

如果尚未将 DragSourceListener 添加到此 DragSourceContext，则添加一个。如果 DragSourceListener 已存在，则此方法抛出 TooManyListenersException。

参数：

dsl - 要添加的 DragSourceListener。注意，虽然不禁止 null，但它作为参数是不可接受的值。

抛出：

TooManyListenersException - 如果已添加 DragSourceListener

TooManyListenersException

removeDragSourceListener

public void removeDragSourceListener(DragSourceListener dsl)

从此 DragSourceContext 移除指定的 DragSourceListener。

参数：

dsl - 要移除的 DragSourceListener；注意，虽然不禁止 null，但它作为参数是不可接受的值。

transferablesFlavorsChanged

public void transferablesFlavorsChanged()

通知同位体该 Transferable 的 DataFlavor 已改变。

dragEnter

public void dragEnter(DragSourceDragEvent dsde)

对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener 调用 dragEnter，并将指定的 DragSourceDragEvent 传递给它们。

指定者：

接口 DragSourceListener 中的 dragEnter

参数：

dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent dsde)

对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceContext 调用 dragOver，并将指定的 DragSourceDragEvent 传递给它们。

指定者：

接口 DragSourceListener 中的 dragOver

参数：

dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent dse)

对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener 调用 dragExit，并将指定的 DragSourceEvent 传递给它们。

指定者：

接口 DragSourceListener 中的 dragExit

参数：

dse - DragSourceEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent dsde)

对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener 调用 dropActionChanged，并将指定的 DragSourceDragEvent 传递给它们。

指定者：

接口 DragSourceListener 中的 dropActionChanged

参数：

dsde - DragSourceDragEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent dsde)

对向此 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener 调用 dragDropEnd，并将指定的 DragSourceDropEvent 传递给它们。

指定者：

接口 DragSourceListener 中的 dragDropEnd

参数：

dsde - DragSourceDropEvent

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent dsde)

对向与此 DragSourceContext 关联的 DragSource 注册的 DragSourceMotionListener 调用 dragMouseMoved，并将指定的 DragSourceDragEvent 传递给它们。

指定者：

接口 DragSourceMotionListener 中的 dragMouseMoved

参数：

dsde - DragSourceDragEvent

从以下版本开始：

1.4

getTransferable

public Transferable getTransferable()

返回与此 DragSourceContext 关联的 Transferable。

返回：

Transferable

updateCurrentCursor

protected void updateCurrentCursor(int sourceAct,
                                   int targetAct,
                                   int status)

如果默认拖动光标行为处于活动状态，则此方法将为默认拖动光标设置受拖动源、放置目标动作和状态支持的指定动作，否则此方法不执行任何操作。

参数：

sourceAct - 受拖动源支持的动作

targetAct - 放置目标动作

status - DEFAULT、ENTER、OVER 和 CHANGED 字段之一