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

Class DragSourceEvent

  • All Implemented Interfaces:
    Serializable
    已知直接子类：
    DragSourceDragEvent ， DragSourceDropEvent 

    public class DragSourceEvent
extends EventObject
    这个类是DragSourceDragEvent和DragSourceDropEvent的基类。

    每当拖动进入，移动或退出拖放站点时，当拖放操作更改时，以及拖动结束时都会生成DragSourceEvent 。 生成的DragSourceEvent的位置在此事件发生时指定屏幕坐标中的鼠标光标位置。

    在没有虚拟设备的多屏幕环境中，光标位置在启动器 GraphicsConfiguration的坐标系中指定。 启动器 GraphicsConfiguration是GraphicsConfiguration的Component ，其中当前拖动操作的拖动手势被识别。 如果光标位置在启动器GraphicsConfiguration的边界GraphicsConfiguration ，则报告的坐标被剪切以适应该GraphicsConfiguration的界限。

    在具有虚拟设备的多屏幕环境中，位置在相应的虚拟坐标系中指定。 如果光标位置在虚拟设备的边界之外，则报告的坐标被剪切以适合虚拟设备的界限。

    从以下版本开始：
    1.2
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • DragSourceEvent

        public DragSourceEvent​(DragSourceContext dsc)
        构造一个DragSourceEvent给定一个指定的DragSourceContext 。 此DragSourceEvent的坐标未指定，因此getLocation将为此事件返回null 。
        参数
        dsc - DragSourceContext
        异常
        IllegalArgumentException - 如果 dsc是 null 。
        另请参见：
        getLocation()

      • DragSourceEvent

        public DragSourceEvent​(DragSourceContext dsc,
                       int x,
                       int y)
        构造一个 DragSourceEvent给定一个指定的 DragSourceContext和光标位置的坐标。
        参数
        dsc - DragSourceContext
        x - 光标位置的水平坐标
        y - 光标位置的垂直坐标
        异常
        IllegalArgumentException - 如果 dsc是 null 。
        从以下版本开始：
        1.4

    • 方法详细信息

      • getDragSourceContext

        public DragSourceContext getDragSourceContext​()
        此方法返回发起事件的 DragSourceContext 。
        结果
        发起事件的 DragSourceContext

      • getLocation

        public Point getLocation​()
        此方法返回一个 Point表示在此事件发生时屏幕坐标中的光标位置，如果未为此事件指定光标位置，则 null 。
        结果
        所述 Point指示光标位置或 null ，如果没有指定光标位置
        从以下版本开始：
        1.4

      • getX

        public int getX​()
        此方法在此事件发生时返回屏幕坐标中光标位置的水平坐标，如果未为此事件指定光标位置，则返回0。
        结果
        指示光标位置的水平坐标的整数，如果未指定光标位置，则为零
        从以下版本开始：
        1.4

      • getY

        public int getY​()
        此方法返回在此事件发生时屏幕坐标中光标位置的垂直坐标，如果未为此事件指定光标位置，则返回0。
        结果
        指示光标位置的垂直坐标的整数，如果未指定光标位置，则为零
        从以下版本开始：
        1.4