- java.lang.Object
-
- java.awt.dnd.DropTarget
-
- 实现的所有接口
-
DropTargetListener
,Serializable
,EventListener
public class DropTarget extends Object implements DropTargetListener, Serializable
该DropTarget
与相关Component
时Component
希望接受拖放操作期间下降。每个
DropTarget
与FlavorMap
相关联。 默认值FlavorMap
此后指定由FlavorMap
返回的SystemFlavorMap.getDefaultFlavorMap()
。- 从以下版本开始:
- 1.2
- 另请参见:
- Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected static class
DropTarget.DropTargetAutoScroller
这个受保护的嵌套类实现了自动滚动
-
构造方法摘要
构造方法 构造器 描述 DropTarget()
创建一个DropTarget
。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
当前是否正在接受丢弃,以及FlavorMap
要使用(或null为默认值FlavorMap
)。DropTarget(Component c, DropTargetListener dtl)
给定Component
以创建DropTarget
,并使用DropTargetListener
处理事件处理。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 void
addDropTargetListener(DropTargetListener dtl)
添加了新的DropTargetListener
(UNICAST SOURCE)。void
addNotify()
通知DropTarget它已与组件关联此方法通常从与此DropTarget关联的Component的java.awt.Component.addNotify()调用,以通知DropTarget ComponentPeer已与该Component关联。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()
通知DropTarget它已从组件中取消关联此方法通常从与此DropTarget关联的组件的java.awt.Component.removeNotify()调用,以通知DropTarget ComponentPeer已与该组件解除关联。void
setActive(boolean isActive)
将DropTarget设置为积极的,如果true
,不活跃,如果false
。void
setComponent(Component c)
注意:此接口需要允许DropTarget与Component以下列两种方式之一安全关联:component.setDropTarget(droptarget);
或droptarget.setComponent(component);
void
setDefaultActions(int ops)
设置此DropTarget
的默认可接受操作void
setFlavorMap(FlavorMap fm)
设置FlavorMap
与这个DropTarget
相关联。protected void
updateAutoscroll(Point dragCursorLocn)
使用当前光标位置更新自动滚动
-
-
-
构造方法详细信息
-
DropTarget
public DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm) throws HeadlessException
在Component
与其关联的情况下创建一个新的DropTarget,int
表示要支持的默认可接受操作,DropTargetListener
用于处理事件处理,boolean
表示DropTarget
当前是否正在接受丢弃,以及FlavorMap
要使用(或null为默认值FlavorMap
)。仅当启用时,组件才会接收丢弃。
- 参数
-
c
-该Component
与此DropTarget
关联 -
ops
- 此DropTarget
的默认可接受操作 -
dtl
- 这个DropTargetListener
的DropTarget
-
act
-act
是否接受DropTarget
。 -
fm
- 要使用的FlavorMap
,或者为默认FlavorMap
nullFlavorMap
- 异常
-
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
当前是否正在接受丢弃。仅当启用时,组件才会接收丢弃。
- 参数
-
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
给定Component
以创建DropTarget
,并使用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
关联 -
ops
- 此DropTarget
的默认可接受操作 -
dtl
- 此DropTargetListener
的DropTarget
- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
-
方法详细信息
-
setComponent
public void setComponent(Component c)
注意:此接口需要允许DropTarget与Component以下列两种方式之一安全关联: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
true
非活动状态。- 参数
-
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
in interfaceDropTargetListener
- 参数
-
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
。 - 另请参见:
-
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()
通知DropTarget它已与组件关联此方法通常从与此DropTarget关联的Component的java.awt.Component.addNotify()调用,以通知DropTarget ComponentPeer已与该Component关联。 调用此方法,除了通知此DropTarget ComponentPeer与Component的关联之外,可能会导致DnD系统出现故障。
-
removeNotify
public void removeNotify()
通知DropTarget它已从组件中取消关联此方法通常从与此DropTarget关联的组件的java.awt.Component.removeNotify()调用,以通知DropTarget ComponentPeer已与该组件解除关联。 调用此方法,除了通知此DropTarget ComponentPeer与Component的解除关联可能会导致DnD系统出现故障。
-
getDropTargetContext
public DropTargetContext getDropTargetContext()
获取DropTargetContext
与此相关DropTarget
。- 结果
-
DropTargetContext
与此DropTarget
相关联。
-
createDropTargetContext
protected DropTargetContext createDropTargetContext()
创建与此DropTarget关联的DropTargetContext。 子类可以重写此方法以实例化它们自己的DropTargetContext子类。 此调用通常*仅由平台的DropTargetContextPeer调用,因为拖动操作遇到此DropTarget。 在没有Drag是当前的情况下访问Context具有未定义的结果。- 结果
- 与此DropTarget关联的DropTargetContext
-
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()
清除自动滚动
-
-