java.awt.dnd

Class DropTarget

java.lang.Object

java.awt.dnd.DropTarget

All Implemented Interfaces:

DropTargetListener ， Serializable ， EventListener

public class DropTarget
extends Object
implements DropTargetListener, Serializable

该DropTarget与相关Component时Component希望接受拖放操作期间下降。

每个DropTarget都与FlavorMap 。 默认FlavorMap以后指定FlavorMap返回的SystemFlavorMap.getDefaultFlavorMap() 。

从以下版本开始：

1.2

另请参见：

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	DropTarget.DropTargetAutoScroller 这个受保护的嵌套类实现自动滚动

构造方法摘要

构造方法

Constructor and Description
DropTarget() 创建一个 DropTarget 。
DropTarget(Component c, DropTargetListener dtl) 创建一个 DropTarget给予 Component来关联自己，和 DropTargetListener处理事件处理。
DropTarget(Component c, int ops, DropTargetListener dtl) 创建一个 DropTarget给定 Component以关联自己，一个 int表示默认可接受的操作支持，一个 DropTargetListener处理事件处理。
DropTarget(Component c, int ops, DropTargetListener dtl, boolean act) 创建 DropTarget给予 Component以关联自己，一个 int表示默认可接受的操作以支持，一个 DropTargetListener处理事件处理，以及 boolean表示 DropTarget是否正在接受丢弃。
DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm) 创建给定一个新的DropTarget Component与之关联，一个 int表示的默认可接受操作（一个或多个）来支持，一个 DropTargetListener来处理事件处理中， boolean指示该 DropTarget当前是否接受drop和 FlavorMap使用（或默认值为 FlavorMap ） FlavorMap ）。

方法摘要

Modifier and Type	Method and Description
void	addDropTargetListener(DropTargetListener dtl) 添加一个新的 DropTargetListener （UNICAST SOURCE）。
void	addNotify(java.awt.peer.ComponentPeer peer) 通知与组件关联的DropTarget此方法通常从与此DropTarget关联的组件的java.awt.Component.addNotify（）中调用，以通知DropTarget ComponentPeer已与该组件相关联。
protected void	clearAutoscroll() 清除自动滚动
protected DropTarget.DropTargetAutoScroller	createDropTargetAutoScroller(Component c, Point p) 创建一个嵌入式自动推送器
protected DropTargetContext	createDropTargetContext() 创建与此DropTarget关联的DropTargetContext。
void	dragEnter(DropTargetDragEvent dtde) 致电 dragEnter注册 DropTargetListener并通过指定的 DropTargetDragEvent 。
void	dragExit(DropTargetEvent dte) 致电 dragExit在注册的 DropTargetListener并通过指定的 DropTargetEvent 。
void	dragOver(DropTargetDragEvent dtde) 致电 dragOver注册 DropTargetListener ，并通过指定的 DropTargetDragEvent 。
void	drop(DropTargetDropEvent dtde) 致电 drop在注册的 DropTargetListener并通过它指定的 DropTargetDropEvent如果这 DropTarget是活动的。
void	dropActionChanged(DropTargetDragEvent dtde) 致电 dropActionChanged在注册的 DropTargetListener并通过指定的 DropTargetDragEvent 。
Component	getComponent() 获取 Component与此相关 DropTarget 。
int	getDefaultActions() 获取一个 int表示受此支持的当前操作（一个或多个） DropTarget 。
DropTargetContext	getDropTargetContext() 获取 DropTargetContext与此相关 DropTarget 。
FlavorMap	getFlavorMap() 获取 FlavorMap与此相关 DropTarget 。
protected void	initializeAutoscrolling(Point p) 初始化自动滚动
boolean	isActive() 报告此 DropTarget是否当前处于活动状态（准备接受滴答）。
void	removeDropTargetListener(DropTargetListener dtl) 删除当前的 DropTargetListener （UNICAST SOURCE）。
void	removeNotify(java.awt.peer.ComponentPeer peer) 通知从组件中取消关联的DropTarget此方法通常从与此DropTarget关联的组件的java.awt.Component.removeNotify（）中调用，以通知DropTarget ComponentPeer已与该组件取消关联。
void	setActive(boolean isActive) 设置DropTarget如果 true激活，如果 false不活动。
void	setComponent(Component c) 注意：此接口需要允许以两种方式之一安全地将DropTarget与组件关联： component.setDropTarget(droptarget);或 droptarget.setComponent(component);
void	setDefaultActions(int ops) 设置此 DropTarget的默认可接受操作
void	setFlavorMap(FlavorMap fm) 设置 FlavorMap与此相关 DropTarget 。
protected void	updateAutoscroll(Point dragCursorLocn) 更新当前光标位置的自动滚动

Methods inherited from class java.lang.Object

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

构造方法详细信息

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl,
                  boolean act,
                  FlavorMap fm)
           throws HeadlessException

创建给定一个新的DropTarget Component与之关联，一个int表示的默认可接受操作（一个或多个）来支持，一个DropTargetListener来处理事件处理中， boolean指示该DropTarget当前是否接受drop和FlavorMap使用（或默认值为FlavorMap ） FlavorMap ）。

组件只有在启用时才会接收到丢弃。

参数

c -该 Component与此 DropTarget关联

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

dtl - DropTargetListener为这 DropTarget

act - 是 DropTarget接受滴。

fm - 要使用的 FlavorMap ，或默认为空值为 FlavorMap

异常

HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true

另请参见：

GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl,
                  boolean act)
           throws HeadlessException

创建DropTarget给出的Component与之关联，一个int表示的默认可接受操作（一个或多个）来支持，一个DropTargetListener来处理事件处理和boolean指示是否DropTarget当前是否接受drop。

组件只有在启用时才会接收到丢弃。

参数

c -该 Component与此 DropTarget关联

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

dtl - DropTargetListener为这 DropTarget

act - 是 DropTarget接受滴。

异常

HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true

另请参见：

GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget()
           throws HeadlessException

创建一个 DropTarget 。

异常

HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true

另请参见：

GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component c,
                  DropTargetListener dtl)
           throws HeadlessException

创建一个DropTarget给定Component来关联自己，和DropTargetListener处理事件处理。

组件只有在启用时才会接收到丢弃。

参数

c -该 Component与此 DropTarget关联

dtl - DropTargetListener为这 DropTarget

异常

HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true

另请参见：

GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl)
           throws HeadlessException

创建一个DropTarget给定Component关联自己，一个int表示默认可接受的操作支持，一个DropTargetListener处理事件处理。

组件只有在启用时才会接收到丢弃。

参数

c - 该 Component与之相关 DropTarget的Component

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

dtl - DropTargetListener为这 DropTarget

异常

HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true

另请参见：

GraphicsEnvironment.isHeadless()

方法详细信息

setComponent

public void setComponent(Component c)

注意：此接口需要允许以两种方式之一安全地将DropTarget与组件关联： component.setDropTarget(droptarget);或droptarget.setComponent(component);

组件只有在启用时才会接收到丢弃。

参数

c - 新的 Component这个 DropTarget是要关联的。

getComponent

public Component getComponent()

获取 Component与此相关 DropTarget 。

结果

目前 Component

setDefaultActions

public void setDefaultActions(int ops)

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

参数

ops - 默认动作

另请参见：

DnDConstants

getDefaultActions

public int getDefaultActions()

获取一个 int表示受此支持的当前操作（一个或多个） DropTarget 。

结果

当前的默认动作

setActive

public void setActive(boolean isActive)

设置DropTarget如果 true激活，如果 false不活动。

参数

isActive - 设置 DropTarget （in）活动。

isActive

public boolean isActive()

报告此 DropTarget是否当前处于活动状态（准备接受滴答）。

结果

true如果活跃， false如果没有

addDropTargetListener

public void addDropTargetListener(DropTargetListener dtl)
                           throws TooManyListenersException

添加一个新的 DropTargetListener （UNICAST SOURCE）。

参数

dtl - 新的 DropTargetListener

异常

TooManyListenersException - 如果 DropTargetListener已经添加到此 DropTarget 。

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener dtl)

删除当前的 DropTargetListener （UNICAST SOURCE）。

参数

dtl - 要注销的DropTargetListener。

dragEnter

public void dragEnter(DropTargetDragEvent dtde)

致电dragEnter在注册的DropTargetListener并通过它指定的DropTargetDragEvent 。 如果DropTarget未激活，则无效。

Specified by:

dragEnter在界面 DropTargetListener

参数

dtde - DropTargetDragEvent

异常

NullPointerException - 如果这个 DropTarget是活动的， dtde是 null

另请参见：

isActive()

dragOver

public void dragOver(DropTargetDragEvent dtde)

致电dragOver注册DropTargetListener并通过指定的DropTargetDragEvent 。 如果DropTarget未激活，则无效。

Specified by:

dragOver在界面 DropTargetListener

参数

dtde - DropTargetDragEvent

异常

NullPointerException - 如果这个 DropTarget是活动的， dtde是 null

另请参见：

isActive()

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

致电dropActionChanged注册DropTargetListener并通过指定的DropTargetDragEvent 。 如果DropTarget未激活，则无效。

Specified by:

dropActionChanged在界面 DropTargetListener

参数

dtde - DropTargetDragEvent

异常

NullPointerException - 如果这个 DropTarget是活跃的， dtde是 null

另请参见：

isActive()

dragExit

public void dragExit(DropTargetEvent dte)

致电dragExit注册DropTargetListener ，并通过指定的DropTargetEvent 。 如果DropTarget未激活，则无效。

此方法本身不会为null参数引发任何异常，而是针对侦听器的相应方法抛出的异常。

Specified by:

dragExit在界面 DropTargetListener

参数

dte - DropTargetEvent

另请参见：

isActive()

drop

public void drop(DropTargetDropEvent dtde)

致电 drop在注册的 DropTargetListener并通过它指定的 DropTargetDropEvent如果这 DropTarget是活动的。

Specified by:

drop在界面 DropTargetListener

参数

dtde - DropTargetDropEvent

异常

NullPointerException - 如果 dtde为空，并且至少有以下一个为真：此 DropTarget未激活，或没有 DropTargetListener DropTargetListener。

另请参见：

isActive()

getFlavorMap

public FlavorMap getFlavorMap()

获取FlavorMap与此相关DropTarget 。 如果没有FlavorMap设置DropTarget ，则与默认值FlavorMap 。

结果

该DropTarget的FlavorMap

setFlavorMap

public void setFlavorMap(FlavorMap fm)

设置 FlavorMap与此相关 DropTarget 。

参数

fm - 新的 FlavorMap ，或null，以将默认FlavorMap与此DropTarget相关联。

addNotify

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

通知与组件关联的DropTarget此方法通常从与此DropTarget关联的组件的java.awt.Component.addNotify（）中调用，以通知DropTarget ComponentPeer已与该组件相关联。 调用此方法，除了将ComponentPeer与组件关联的此DropTarget通知可能会导致DnD系统故障。

参数

peer - 与我们联系的组件的同伴！

removeNotify

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

通知从组件中取消关联的DropTarget此方法通常从与此DropTarget关联的组件的java.awt.Component.removeNotify（）中调用，以通知DropTarget ComponentPeer已与该组件取消关联。 调用此方法，除了通知此DropTarget之外，ComponentPeer从Component中取消关联可能会导致DnD系统发生故障。

参数

peer - 我们正在脱离的组件的同伴！

getDropTargetContext

public DropTargetContext getDropTargetContext()

获取 DropTargetContext与此相关 DropTarget 。

结果

该 DropTargetContext与此相关 DropTarget 。

createDropTargetContext

protected DropTargetContext createDropTargetContext()

创建与此DropTarget关联的DropTargetContext。 子类可以覆盖此方法来实例化自己的DropTargetContext子类。 这个调用通常仅由平台的DropTargetContextPeer调用，因为拖动操作遇到此DropTarget。 当没有拖动当前时访问上下文有未定义的结果。

createDropTargetAutoScroller

protected DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Component c,
                                                                         Point p)

创建一个嵌入式自动推送器

参数

c - Component

p - Point

initializeAutoscrolling

protected void initializeAutoscrolling(Point p)

初始化自动滚动

参数

p - Point

updateAutoscroll

protected void updateAutoscroll(Point dragCursorLocn)

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

参数

dragCursorLocn - Point

clearAutoscroll

protected void clearAutoscroll()

清除自动滚动