DropTarget (Java Platform SE 8 )

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()
```
    清除自动滚动

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class DropTarget

Nested Class Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

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