模块  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 - 这个 DropTargetListener的 DropTarget
        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 - 这个 DropTargetListener的 DropTarget
        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 - 此 DropTargetListener的 DropTarget
        异常
        HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true
        另请参见：
        GraphicsEnvironment.isHeadless()

    • 方法详细信息

      • setComponent

        public void setComponent​(Component c)
        注意：此接口需要允许DropTarget与Component以下列两种方式之一安全关联： 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 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有效且 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关联的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()
        清除自动滚动