Module  java.desktop
软件包  java.awt.dnd

Class DropTarget

    • 构造方法详细信息

      • DropTarget

        public DropTarget​(Component c,
                  int ops,
                  DropTargetListener dtl,
                  boolean act,
                  FlavorMap fm)
           throws HeadlessException
        创建一个新的DropTarget，给出了Component来关联自己，一个int表示默认可接受的操作来支持，一个DropTargetListener处理事件处理，一个boolean指示DropTarget是否正在接受丢弃，以及一个FlavorMap （或null为默认值FlavorMap ）。

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

        参数
        c -该 Component与此 DropTarget关联
        ops - 此 DropTarget的默认可接受操作
        dtl - DropTargetListener为这 DropTarget
        act - 是 DropTarget接受滴。
        fm - 要使用的 FlavorMap ，或默认为null FlavorMap
        异常
        HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true
        另请参见：
        GraphicsEnvironment.isHeadless()

      • DropTarget

        public DropTarget​(Component c,
                  int ops,
                  DropTargetListener dtl,
                  boolean act)
           throws HeadlessException
        创建一个DropTarget给出Component以自己的int ，一个int表示默认可接受的动作，以支持，一个DropTargetListener来处理事件处理，以及一个boolean指示DropTarget是否正在接受丢弃。

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

        参数
        c -该 Component与此 DropTarget关联
        ops - 此 DropTarget的默认可接受操作
        dtl - DropTargetListener为这 DropTarget
        act - 是 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关联
        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 ，如果为 true ，则 false 。
        参数
        isActive - 设置 DropTarget （in）活动。

      • isActive

        public boolean isActive​()
        报告此 DropTarget是否当前处于活动状态（准备接受 DropTarget ）。
        结果
        true如果活动， false如果没有

      • 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 。
        另请参见：
        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关联的组件的java.awt.Component.addNotify（）中调用，以通知DropTarget ComponentPeer已与该组件相关联。 调用此方法，除了将ComponentPeer与组件关联的此DropTarget通知可能会导致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。 当没有拖动当前时访问上下文有未定义的结果。
        结果
        与此DropTarget关联的DropTargetContext

      • initializeAutoscrolling

        protected void initializeAutoscrolling​(Point p)
        初始化自动滚动
        参数
        p - Point

      • updateAutoscroll

        protected void updateAutoscroll​(Point dragCursorLocn)
        更新当前光标位置的自动滚动
        参数
        dragCursorLocn - Point

      • clearAutoscroll

        protected void clearAutoscroll​()
        清除自动滚动