模块  java.desktop
软件包  java.awt.dnd

Class DropTarget

    • 构造方法详细信息

      • DropTarget

        public DropTarget​(Component c,
                          int ops,
                          DropTargetListener dtl,
                          boolean act,
                          FlavorMap fm)
                   throws HeadlessException
        Component与其关联的情况下创建一个新的DropTarget, int表示要支持的默认可接受操作, DropTargetListener用于处理事件处理, boolean表示DropTarget当前是否正在接受丢弃,以及FlavorMap要使用(或null为默认值FlavorMap )。

        仅当启用时,组件才会接收丢弃。

        参数
        c -该 Component与此 DropTarget关联
        ops - 此 DropTarget的默认可接受操作
        dtl - 这个 DropTargetListenerDropTarget
        act - act是否接受 DropTarget
        fm - 要使用的 FlavorMap ,或者为默认 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表示要支持的默认可接受操作, DropTargetListener处理事件处理,以及boolean指示DropTarget当前是否正在接受丢弃。

        仅当启用时,组件才会接收丢弃。

        参数
        c -该 Component与此 DropTarget关联
        ops - 此 DropTarget的默认可接受操作
        dtl - 这个 DropTargetListenerDropTarget
        act -是 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 - 此 DropTargetListenerDropTarget
        异常
        HeadlessException - 如果GraphicsEnvironment.isHeadless()返回true
        另请参见:
        GraphicsEnvironment.isHeadless()
    • 方法详细信息

      • setComponent

        public void setComponent​(Component c)
        注意:此接口需要允许DropTarget与Component以下列两种方式之一安全关联: component.setDropTarget(droptarget);droptarget.setComponent(component);

        仅当启用时,组件才会接收丢弃。

        参数
        c - 新的 ComponentDropTarget相关联。
      • 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 true非活动状态。
        参数
        isActive - 将 DropTarget (in)设置为活动状态。
      • isActive

        public boolean isActive()
        报告此 DropTarget当前是否处于活动状态(准备接受丢弃)。
        结果
        true如果有效, false如果没有
      • removeDropTargetListener

        public void removeDropTargetListener​(DropTargetListener dtl)
        删除当前的 DropTargetListener (UNICAST SOURCE)。
        参数
        dtl - 要取消注册的DropTargetListener。
      • dropActionChanged

        public void dropActionChanged​(DropTargetDragEvent dtde)
        电话dropActionChanged的注册DropTargetListener ,并传递给指定DropTargetDragEvent 如果此DropTarget未激活,则无效。
        Specified by:
        dropActionChanged in interface 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关联的Component的java.awt.Component.addNotify()调用,以通知DropTarget ComponentPeer已与该Component关联。 调用此方法,除了通知此DropTarget ComponentPeer与Component的关联之外,可能会导致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。 在没有Drag是当前的情况下访问Context具有未定义的结果。
        结果
        与此DropTarget关联的DropTargetContext
      • initializeAutoscrolling

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

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

        protected void clearAutoscroll()
        清除自动滚动