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是活动的,而 dtdenull
        另请参见:
        isActive()
      • dragOver

        public void dragOver​(DropTargetDragEvent dtde)
        致电dragOver注册DropTargetListener并通过指定的DropTargetDragEvent 没有效果,如果这个DropTarget没有活动。
        Specified by:
        dragOver在接口 DropTargetListener
        参数
        dtde - DropTargetDragEvent
        异常
        NullPointerException - 如果这个 DropTarget是活动的,而 dtdenull
        另请参见:
        isActive()
      • dropActionChanged

        public void dropActionChanged​(DropTargetDragEvent dtde)
        致电dropActionChanged在注册的DropTargetListener并通过它指定的DropTargetDragEvent 没有效果,如果这个DropTarget没有活动。
        Specified by:
        dropActionChanged在接口 DropTargetListener
        参数
        dtde - DropTargetDragEvent
        异常
        NullPointerException - 如果这个 DropTarget是活动的,而 dtdenull
        另请参见:
        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​()
        清除自动滚动