|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.dnd.DropTarget
public class DropTarget
在 Drag 和 Drop 操作期间,当 Component
希望接受 drop 时,DropTarget
与 Component
有关联。
每个 DropTarget
都与一个 FlavorMap
关联。这之后默认的 FlavorMap
指定 SystemFlavorMap.getDefaultFlavorMap()
所返回的 FlavorMap
。
嵌套类摘要 | |
---|---|
protected static class |
DropTarget.DropTargetAutoScroller 此受保护的嵌套类实现自动滚动 |
构造方法摘要 | |
---|---|
DropTarget() 创建一个 DropTarget |
|
DropTarget(Component c, DropTargetListener dtl) 在给出与之关联的 Component 和执行事件处理的 DropTargetListener 的情况下创建一个 DropTarget 。 |
|
DropTarget(Component c, int ops, DropTargetListener dtl) 在给出与之关联的 Component 、表示支持的默认可接受操作的 int 值和执行事件处理的 DropTargetListener 的情况下,创建一个 DropTarget 。 |
|
DropTarget(Component c, int ops, DropTargetListener dtl, boolean act) 在给出与之关联的 Component 、表示支持的默认可接受操作的 int 值、执行事件处理的 DropTargetListener 和表示 DropTarget 当前是否接受 drop 的 boolean 值的情况下,创建一个 DropTarget 。 |
|
DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm) 在给出与之关联的 Component 、表示要支持的默认可接受操作的 int 值、执行事件处理的 DropTargetListener 、表示 DropTarget 当前是否接受 drop 的 boolean 值和要使用的 FlavorMap (使用默认 FlavorMap 时为 null)的情况下,创建一个新的 DropTarget。 |
方法摘要 | |
---|---|
void |
addDropTargetListener(DropTargetListener dtl) 添加一个新的 DropTargetListener (UNICAST SOURCE)。 |
void |
addNotify(java.awt.peer.ComponentPeer peer) 通知 DropTarget 它已经与某个 Component 关联。 |
protected void |
clearAutoscroll() 清除自动滚动 |
protected DropTarget.DropTargetAutoScroller |
createDropTargetAutoScroller(Component c, Point p) 创建一个嵌入式自动滚动条 |
protected DropTargetContext |
createDropTargetContext() 创建与此 DropTarget 关联的 DropTargetContext。 |
void |
dragEnter(DropTargetDragEvent dtde) 在已注册的 DropTargetListener 上调用 dragEnter ,并将其传递给指定的 DropTargetDragEvent 。 |
void |
dragExit(DropTargetEvent dte) 在已注册的 DropTargetListener 上调用 dragExit ,并将其传递给指定的 DropTargetEvent 。 |
void |
dragOver(DropTargetDragEvent dtde) 在已注册的 DropTargetListener 上调用 dragOver ,并将其传递给指定的 DropTargetDragEvent 。 |
void |
drop(DropTargetDropEvent dtde) 如果此 DropTarget 处于激活状态,则在已注册的 DropTargetListener 上调用 drop ,并将其传递给指定的 DropTargetDropEvent 。 |
void |
dropActionChanged(DropTargetDragEvent dtde) 在已注册的 DropTargetListener 上调用 dropActionChanged ,并将其传递给指定的 DropTargetDragEvent 。 |
Component |
getComponent() 获取与此 DropTarget 关联的 Component 。 |
int |
getDefaultActions() 获取表示受此 DropTarget 支持的当前操作的 int 值。 |
DropTargetContext |
getDropTargetContext() 获取与此 DropTarget 关联的 DropTargetContext 。 |
FlavorMap |
getFlavorMap() 获取与此 DropTarget 关联的 FlavorMap 。 |
protected void |
initializeAutoscrolling(Point p) 初始化自动滚动 |
boolean |
isActive() 报告此 DropTarget 当前是否为激活状态(准备接受 drop)。 |
void |
removeDropTargetListener(DropTargetListener dtl) 移除当前的 DropTargetListener (UNICAST SOURCE)。 |
void |
removeNotify(java.awt.peer.ComponentPeer peer) 通知 DropTarget 它已经与某个 Component 解除关联。 |
void |
setActive(boolean isActive) 如果为 true ,则将 DropTarget 设置为激活状态;如果为 false ,则将 DropTarget 设置为非激活状态。 |
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) 使用当前的光标位置更新自动滚动 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm) 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()
public DropTarget(Component c, int ops, DropTargetListener dtl, boolean act) 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()
public DropTarget() throws HeadlessException
DropTarget
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 true
GraphicsEnvironment.isHeadless()
public DropTarget(Component c, DropTargetListener dtl) throws HeadlessException
Component
和执行事件处理的
DropTargetListener
的情况下创建一个
DropTarget
。
仅在已启用时 Component 才会接收 drop。
c
- 与此
DropTarget
有关联的
Component
dtl
- 此
DropTarget
的
DropTargetListener
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 true
GraphicsEnvironment.isHeadless()
public DropTarget(Component c, int ops, DropTargetListener dtl) throws HeadlessException
Component
、表示支持的默认可接受操作的
int
值和执行事件处理的
DropTargetListener
的情况下,创建一个
DropTarget
。
仅在已启用时 Component 才会接收 drop。
c
- 与此
DropTarget
有关联的
Component
ops
- 此
DropTarget
的默认可接受操作
dtl
- 此
DropTarget
的
DropTargetListener
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 true
GraphicsEnvironment.isHeadless()
方法详细信息 |
---|
public void setComponent(Component c)
component.setDropTarget(droptarget)
或
droptarget.setComponent(component)
。
仅在已启用时 Component 才会接收 drop。
c
- 此
DropTarget
要关联的新
Component
。
public Component getComponent()
DropTarget
关联的
Component
。
Component
public void setDefaultActions(int ops)
DropTarget
设置默认的可接受操作。
ops
- 默认操作
DnDConstants
public int getDefaultActions()
DropTarget
支持的当前操作的
int
值。
public void setActive(boolean isActive)
true
,则将 DropTarget 设置为激活状态;如果为
false
,则将 DropTarget 设置为非激活状态。
isActive
- 将
DropTarget
设置为(非)激活状态。
public boolean isActive()
DropTarget
当前是否为激活状态(准备接受 drop)。
true
;否则返回
false
public void addDropTargetListener(DropTargetListener dtl) throws TooManyListenersException
DropTargetListener
(UNICAST SOURCE)。
dtl
- 新的
DropTargetListener
TooManyListenersException
- 如果已向此
DropTarget
添加
DropTargetListener
。
TooManyListenersException
public void removeDropTargetListener(DropTargetListener dtl)
DropTargetListener
(UNICAST SOURCE)。
dtl
- 要取消注册的 DropTargetListener。
public void dragEnter(DropTargetDragEvent dtde)
DropTargetListener
上调用
dragEnter
,并将其传递给指定的
DropTargetDragEvent
。 如果此
DropTarget
是非激活状态,则此调用无效。
DropTargetListener
中的
dragEnter
dtde
-
DropTargetDragEvent
NullPointerException
- 如果此
DropTarget
处于激活状态并且
dtde
为
null
isActive()
public void dragOver(DropTargetDragEvent dtde)
DropTargetListener
上调用
dragOver
,并将其传递给指定的
DropTargetDragEvent
。 如果此
DropTarget
是非激活状态,则该调用无效。
DropTargetListener
中的
dragOver
dtde
-
DropTargetDragEvent
NullPointerException
- 如果此
DropTarget
处于激活状态并且
dtde
为
null
isActive()
public void dropActionChanged(DropTargetDragEvent dtde)
DropTargetListener
上调用
dropActionChanged
,并将其传递给指定的
DropTargetDragEvent
。 如果此
DropTarget
是非激活状态,则此调用无效。
DropTargetListener
中的
dropActionChanged
dtde
-
DropTargetDragEvent
NullPointerException
- 如果此
DropTarget
处于激活状态并且
dtde
为
null
isActive()
public void dragExit(DropTargetEvent dte)
DropTargetListener
上调用
dragExit
,并将其传递给指定的
DropTargetEvent
。 如果此
DropTarget
是非激活状态,则此调用无效。
对于 null 参数,此方法本身并不抛出任何异常,而是由相应的侦听器方法抛出异常。
DropTargetListener
中的
dragExit
dte
-
DropTargetEvent
isActive()
public void drop(DropTargetDropEvent dtde)
DropTarget
处于激活状态,则在已注册的
DropTargetListener
上调用
drop
,并将其传递给指定的
DropTargetDropEvent
。
DropTargetListener
中的
drop
dtde
-
DropTargetDropEvent
NullPointerException
- 如果
dtde
为 null 并且以下条件中至少有一个为真:此
DropTarget
不处于激活状态,或者没有已注册的
DropTargetListener
。
isActive()
public FlavorMap getFlavorMap()
DropTarget
关联的
FlavorMap
。 如果没有为此
DropTarget
设置
FlavorMap
,则它与默认的
FlavorMap
关联。
public void setFlavorMap(FlavorMap fm)
FlavorMap
与此
DropTarget
关联。
fm
- 新的
FlavorMap
,如果将默认的 FlavorMap 与此 DropTarget 关联,则为 null。
public void addNotify(java.awt.peer.ComponentPeer peer)
peer
- 与该 Component 关联的同位体
public void removeNotify(java.awt.peer.ComponentPeer peer)
peer
- 与该 Component 解除关联的同位体
public DropTargetContext getDropTargetContext()
DropTarget
关联的
DropTargetContext
。
DropTarget
关联的
DropTargetContext
。
protected DropTargetContext createDropTargetContext()
protected DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Component c, Point p)
c
-
Component
p
-
Point
protected void initializeAutoscrolling(Point p)
p
-
Point
protected void updateAutoscroll(Point dragCursorLocn)
dragCursorLocn
-
Point
protected void clearAutoscroll()
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。