DropTarget

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt.dnd
类 DropTarget

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 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()

DropTarget

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()

DropTarget

public DropTarget()
           throws HeadlessException

创建一个 DropTarget

抛出：: HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true
另请参见：: GraphicsEnvironment.isHeadless()

DropTarget

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()

DropTarget

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()

方法详细信息

setComponent

public void setComponent(Component c)

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

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

参数：: c - 此 DropTarget 要关联的新 Component。

getComponent

public Component getComponent()

获取与此 DropTarget 关联的 Component。

返回：: 当前的 Component

setDefaultActions

public void setDefaultActions(int ops)

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

参数：: ops - 默认操作
另请参见：: DnDConstants

getDefaultActions

public int getDefaultActions()

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

返回：: 当前的默认操作

setActive

public void setActive(boolean isActive)

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

参数：: isActive - 将 DropTarget 设置为（非）激活状态。

isActive

public boolean isActive()

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

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

addDropTargetListener

public void addDropTargetListener(DropTargetListener dtl)
                           throws TooManyListenersException

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

参数：: dtl - 新的 DropTargetListener
抛出：: TooManyListenersException - 如果已向此 DropTarget 添加 DropTargetListener。; TooManyListenersException

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener dtl)

移除当前的 DropTargetListener (UNICAST SOURCE)。

参数：: dtl - 要取消注册的 DropTargetListener。

dragEnter

public void dragEnter(DropTargetDragEvent dtde)

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

指定者：: 接口 DropTargetListener 中的 dragEnter

参数：: dtde - DropTargetDragEvent
抛出：: NullPointerException - 如果此 DropTarget 处于激活状态并且 dtde 为 null
另请参见：: isActive()

dragOver

public void dragOver(DropTargetDragEvent dtde)

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

指定者：: 接口 DropTargetListener 中的 dragOver

参数：: dtde - DropTargetDragEvent
抛出：: NullPointerException - 如果此 DropTarget 处于激活状态并且 dtde 为 null
另请参见：: isActive()

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

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

指定者：: 接口 DropTargetListener 中的 dropActionChanged

参数：: dtde - DropTargetDragEvent
抛出：: NullPointerException - 如果此 DropTarget 处于激活状态并且 dtde 为 null
另请参见：: isActive()

dragExit

public void dragExit(DropTargetEvent dte)

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

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

指定者：: 接口 DropTargetListener 中的 dragExit

参数：: dte - DropTargetEvent
另请参见：: isActive()

drop

public void drop(DropTargetDropEvent dtde)

如果此 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(FlavorMap fm)

设置 FlavorMap 与此 DropTarget 关联。

参数：: fm - 新的 FlavorMap，如果将默认的 FlavorMap 与此 DropTarget 关联，则为 null。

addNotify

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

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

参数：: peer - 与该 Component 关联的同位体

removeNotify

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

通知 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(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()

清除自动滚动

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

java.awt.dnd 类 DropTarget

DropTarget

DropTarget

DropTarget

DropTarget

DropTarget

setComponent

getComponent

setDefaultActions

getDefaultActions

setActive

isActive

addDropTargetListener

removeDropTargetListener

dragEnter

dragOver

dropActionChanged

dragExit

drop

getFlavorMap

setFlavorMap

addNotify

removeNotify

getDropTargetContext

createDropTargetContext

createDropTargetAutoScroller

initializeAutoscrolling

updateAutoscroll

clearAutoscroll

java.awt.dnd
类 DropTarget