Question

java.lang.Object
  └java.awt.dnd.DropTarget

所有已实现的接口：

DropTargetListener, Serializable, EventListener

---

public class DropTarget

extends Object

implements DropTargetListener, Serializable

在 Drag 和 Drop 操作期间，当 Component 希望接受 drop 时， DropTarget 与 Component 有关联。

每个 DropTarget 都与一个 FlavorMap 关联。这之后指定默认的 FlavorMap 是 SystemFlavorMap.getDefaultFlavorMap() 所返回的 FlavorMap

从以下版本开始：

1.2

另请参见：

序列化表格

---

嵌套类摘要
protected staticclass	DropTarget.DropTargetAutoScroller 此受保护的嵌套类实现自动滚动

构造方法摘要
DropTarget() 创建一个 DropTarget
DropTarget(Componentc, DropTargetListenerdtl) 在给出与之关联的 Component 和执行事件处理的 DropTargetListener 的情况下创建一个 DropTarget 。
DropTarget(Componentc, intops, DropTargetListenerdtl) 在给出与之关联的 Component 、表示支持的默认可接受操作的 int 值和执行事件处理的 DropTargetListener 的情况下，创建一个 DropTarget 。
DropTarget(Componentc, intops, DropTargetListenerdtl, booleanact) 在给出与之关联的 Component 、表示支持的默认可接受操作的 int 值、执行事件处理的 DropTargetListener 和表示 DropTarget 当前是否接受 drop 的 boolean 值的情况下，创建一个 DropTarget 。
DropTarget(Componentc, intops, DropTargetListenerdtl, booleanact, FlavorMapfm) 在给出与之关联的 Component 、表示要支持的默认可接受操作的 int 值、执行事件处理的 DropTargetListener 、表示 DropTarget 当前是否接受 drop 的 boolean 值和要使用的 FlavorMap （使用默认 FlavorMap 时为 null）的情况下，创建一个新的 DropTarget。

方法摘要
void	addDropTargetListener(DropTargetListenerdtl) 添加一个新的 DropTargetListener (UNICAST SOURCE)。
void	addNotify(java.awt.peer.ComponentPeerpeer) 通知 DropTarget 它已经与某个 Component 关联。
protected void	clearAutoscroll() 清除自动滚动
protected DropTarget.DropTargetAutoScroller	createDropTargetAutoScroller(Componentc, Pointp) 创建一个嵌入式自动滚动条
protected DropTargetContext	createDropTargetContext() 创建与此 DropTarget 关联的 DropTargetContext。
void	dragEnter(DropTargetDragEventdtde) 在已注册的 DropTargetListener 上调用 dragEnter ，并将其传递给指定的 DropTargetDragEvent 。
void	dragExit(DropTargetEventdte) 在已注册的 DropTargetListener 上调用 dragExit ，并将其传递给指定的 DropTargetEvent 。
void	dragOver(DropTargetDragEventdtde) 在已注册的 DropTargetListener 上调用 dragOver ，并将其传递给指定的 DropTargetDragEvent 。
void	drop(DropTargetDropEventdtde) 如果此 DropTarget 处于激活状态，则在已注册的 DropTargetListener 上调用 drop ，并将其传递给指定的 DropTargetDropEvent 。
void	dropActionChanged(DropTargetDragEventdtde) 在已注册的 DropTargetListener 上调用 dropActionChanged ，并将其传递给指定的 DropTargetDragEvent 。
Component	getComponent() 获得与此 DropTarget 关联的 Component 。
int	getDefaultActions() 获得表示受此 DropTarget 支持的当前操作的 int 值。
DropTargetContext	getDropTargetContext() 获得与此 DropTarget 关联的 DropTargetContext 。
FlavorMap	getFlavorMap() 获得与此 DropTarget 关联的 FlavorMap 。
protected void	initializeAutoscrolling(Pointp) 初始化自动滚动
boolean	isActive() 报告此 DropTarget 当前是否为激活状态（准备接受 drop）。
void	removeDropTargetListener(DropTargetListenerdtl) 移除当前的 DropTargetListener (UNICAST SOURCE)。
void	removeNotify(java.awt.peer.ComponentPeerpeer) 通知 DropTarget 它已经与某个 Component 解除关联。
void	setActive(booleanisActive) 如果为 true ，则将 DropTarget 设置为激活状态，如果为 false ，则将 DropTarget 设置为非激活状态。
void	setComponent(Componentc) 注意：要求此接口允许 DropTarget 以下面两种方式之一与 Component 安全关联： component.setDropTarget(droptarget) 或 droptarget.setComponent(component) 。
void	setDefaultActions(intops) 为此 DropTarget 设置默认的可接受操作。
void	setFlavorMap(FlavorMapfm) 设置 FlavorMap 与此 DropTarget 关联。
protected void	updateAutoscroll(PointdragCursorLocn) 使用当前的光标位置更新自动滚动

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

DropTarget

public DropTarget(Componentc,
                  intops,
                  DropTargetListenerdtl,
                  booleanact,
                  FlavorMapfm)
           throws HeadlessException

在给出与之关联的 Component 、表示要支持的默认可接受操作的 int 值、执行事件处理的 DropTargetListener 、表示 DropTarget 当前是否接受 drop 的 boolean 值和要使用的 FlavorMap （使用默认 FlavorMap 时为 null）的情况下，创建一个新的 DropTarget。

仅在已启用时 Component 才会接收 drop。

参数：

c - 与此 DropTarget 有关联的 Component

ops - 此 DropTarget 的默认可接受操作

dtl - 此 DropTarget 的 DropTargetListener

act - DropTarget 是否接收 drop。

fm - 要使用的 FlavorMap ，使用默认 FlavorMap 时为 null

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

另请参见：

GraphicsEnvironment.isHeadless()

---

DropTarget

public DropTarget(Componentc,
                  intops,
                  DropTargetListenerdtl,
                  booleanact)
           throws HeadlessException

在给出与之关联的 Component 、表示支持的默认可接受操作的 int 值、执行事件处理的 DropTargetListener 和表示 DropTarget 当前是否接受 drop 的 boolean 值的情况下，创建一个 DropTarget 。

仅在已启用时 Component 才会接收 drop。

参数：

c - 与此 DropTarget 有关联的 Component

ops - 此 DropTarget 的默认可接受操作

dtl - 此 DropTarget 的 DropTargetListener

act - DropTarget 是否接收 drop。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

另请参见：

GraphicsEnvironment.isHeadless()

---

DropTarget

public DropTarget()
           throws HeadlessException

创建一个 DropTarget

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

另请参见：

GraphicsEnvironment.isHeadless()

---

DropTarget

public DropTarget(Componentc,
                  DropTargetListenerdtl)
           throws HeadlessException

在给出与之关联的 Component 和执行事件处理的 DropTargetListener 的情况下创建一个 DropTarget 。

仅在已启用时 Component 才会接收 drop。

参数：

c - 与此 DropTarget 有关联的 Component

dtl - 此 DropTarget 的 DropTargetListener

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

另请参见：

GraphicsEnvironment.isHeadless()

---

DropTarget

public DropTarget(Componentc,
                  intops,
                  DropTargetListenerdtl)
           throws HeadlessException

在给出与之关联的 Component 、表示支持的默认可接受操作的 int 值和执行事件处理的 DropTargetListener 的情况下，创建一个 DropTarget 。

仅在已启用时 Component 才会接收 drop。

参数：

c - 与此 DropTarget 有关联的 Component

ops - 此 DropTarget 的默认可接受操作

dtl - 此 DropTarget 的 DropTargetListener

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

另请参见：

GraphicsEnvironment.isHeadless()

方法详细信息

setComponent

public void setComponent(Componentc)

注意：要求此接口允许 DropTarget 以下面两种方式之一与 Component 安全关联： component.setDropTarget(droptarget) 或 droptarget.setComponent(component) 。

仅在已启用时 Component 才会接收 drop。

参数：

c - 此 DropTarget 要关联的新 Component 。

---

getComponent

public Component getComponent()

获得与此 DropTarget 关联的 Component 。

返回：

当前的 Component

---

setDefaultActions

public void setDefaultActions(intops)

为此 DropTarget 设置默认的可接受操作。

参数：

ops - 默认操作

另请参见：

DnDConstants

---

getDefaultActions

public int getDefaultActions()

获得表示受此 DropTarget 支持的当前操作的 int 值。

返回：

当前的默认操作

---

setActive

public void setActive(booleanisActive)

如果为 true ，则将 DropTarget 设置为激活状态，如果为 false ，则将 DropTarget 设置为非激活状态。

参数：

isActive - 将 DropTarget 设置为（非）激活状态。

---

isActive

public boolean isActive()

报告此 DropTarget 当前是否为激活状态（准备接受 drop）。

返回：

如果为激活状态，则返回 true ；否则返回 false

---

addDropTargetListener

public void addDropTargetListener(DropTargetListenerdtl)
                           throws TooManyListenersException

添加一个新的 DropTargetListener (UNICAST SOURCE)。

参数：

dtl - 新的 DropTargetListener

抛出：

TooManyListenersException - 如果已向此 DropTarget 添加 DropTargetListener 。

TooManyListenersException

---

removeDropTargetListener

public void removeDropTargetListener(DropTargetListenerdtl)

移除当前的 DropTargetListener (UNICAST SOURCE)。

参数：

dtl - 要取消注册的 DropTargetListener。

---

dragEnter

public void dragEnter(DropTargetDragEventdtde)

在已注册的 DropTargetListener 上调用 dragEnter ，并将其传递给指定的 DropTargetDragEvent 。 如果此 DropTarget 是非激活状态，则此调用无效。

指定者：

接口 DropTargetListener 中的 dragEnter

参数：

dtde - DropTargetDragEvent

抛出：

NullPointerException - 如果此 DropTarget 处于激活状态并且 dtde 为 null

另请参见：

isActive()

---

dragOver

public void dragOver(DropTargetDragEventdtde)

在已注册的 DropTargetListener 上调用 dragOver ，并将其传递给指定的 DropTargetDragEvent 。 如果此 DropTarget 是非激活状态，则该调用无效。

指定者：

接口 DropTargetListener 中的 dragOver

参数：

dtde - DropTargetDragEvent

抛出：

NullPointerException - 如果此 DropTarget 处于激活状态并且 dtde 为 null

另请参见：

isActive()

---

dropActionChanged

public void dropActionChanged(DropTargetDragEventdtde)

在已注册的 DropTargetListener 上调用 dropActionChanged ，并将其传递给指定的 DropTargetDragEvent 。 如果此 DropTarget 是非激活状态，则此调用无效。

指定者：

接口 DropTargetListener 中的 dropActionChanged

参数：

dtde - DropTargetDragEvent

抛出：

NullPointerException - 如果此 DropTarget 处于激活状态并且 dtde 为 null

另请参见：

isActive()

---

dragExit

public void dragExit(DropTargetEventdte)

在已注册的 DropTargetListener 上调用 dragExit ，并将其传递给指定的 DropTargetEvent 。 如果此 DropTarget 是非激活状态，则此调用无效。

对于 null 参数，此方法本身并不抛出任何异常，而是由相应的侦听器方法抛出异常。

指定者：

接口 DropTargetListener 中的 dragExit

参数：

dte - DropTargetEvent

另请参见：

isActive()

---

drop

public void drop(DropTargetDropEventdtde)

如果此 DropTarget 处于激活状态，则在已注册的 DropTargetListener 上调用 drop ，并将其传递给指定的 DropTargetDropEvent 。

指定者：

接口 DropTargetListener 中的 drop

参数：

dtde - DropTargetDropEvent

抛出：

NullPointerException - 如果 dtde 为 null 并且以下条件中至少有一个为真：此 DropTarget 不处于激活状态，或者没有已注册的 DropTargetListener 。

另请参见：

isActive()

---

getFlavorMap

public FlavorMap getFlavorMap()

获得与此 DropTarget 关联的 FlavorMap 。 如果没有为此 DropTarget 设置 FlavorMap ，则它与默认的 FlavorMap 关联。

返回：

此 DropTarget 的 FlavorMap

---

setFlavorMap

public void setFlavorMap(FlavorMapfm)

设置 FlavorMap 与此 DropTarget 关联。

参数：

fm - 新的 FlavorMap ，或者如果将默认的 FlavorMap 与此 DropTarget 关联，则为 null。

---

addNotify

public void addNotify(java.awt.peer.ComponentPeerpeer)

通知 DropTarget 它已经与某个 Component 关联。通常从与此 DropTarget 相关联 Component 的 java.awt.Component.addNotify() 调用此方法，以通知 DropTarget 一个 ComponentPeer 已经与该 Component 关联。调用此方法，而不是将 ComponentPeer 与 Component 的关联通知给此 DropTarget，这可能导致 DnD 系统故障。

参数：

peer - 与该 Component 关联的同位体

---

removeNotify

public void removeNotify(java.awt.peer.ComponentPeerpeer)

通知 DropTarget 它已经与某个 Component 解除关联。通常从与此 DropTarget 相关联 Component 的 java.awt.Component.removeNotify() 调用此方法，以通知 DropTarget 一个 ComponentPeer 已经与该 Component 解除关联。调用此方法，而不是将 ComponentPeer 与 Component 的解除关联通知给此 DropTarget，这可能导致 DnD 系统故障。

参数：

peer - 与该 Component 解除关联的同位体

---

getDropTargetContext

public DropTargetContext getDropTargetContext()

获得与此 DropTarget 关联的 DropTargetContext 。

返回：

与此 DropTarget 关联的 DropTargetContext 。

---

createDropTargetContext

protected DropTargetContext createDropTargetContext()

创建与此 DropTarget 关联的 DropTargetContext。子类可能重写此方法，以实例化它自己的 DropTargetContext 子类。 通常只在拖动操作遇到此 DropTarget 时才由平台的 DropTargetContextPeer 调用此方法。在当前没有 Drag 时访问 Context 的结果是不明确的。

---

createDropTargetAutoScroller

protected DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Componentc,
                                                                         Pointp)

创建一个嵌入式自动滚动条

参数：

c - Component

p - Point

---

initializeAutoscrolling

protected void initializeAutoscrolling(Pointp)

初始化自动滚动

参数：

p - Point

---

updateAutoscroll

protected void updateAutoscroll(PointdragCursorLocn)

使用当前的光标位置更新自动滚动

参数：

dragCursorLocn - Point

---

clearAutoscroll

protected void clearAutoscroll()

清除自动滚动