モジュール java.desktop
パッケージ java.awt.dnd

クラスDragSourceEvent

  • すべての実装されたインタフェース:
    Serializable
    直系の既知のサブクラス:
    DragSourceDragEvent, DragSourceDropEvent
    public class DragSourceEvent
extends EventObject
    このクラスは、DragSourceDragEventとDragSourceDropEventの基底クラスです。

    DragSourceEventは、ドラッグによってドロップ・サイトに入ったり、移動したり、出たりした場合、ドロップ・アクションが変更された場合、およびドラッグが終了した場合は常に生成されます。 生成されたDragSourceEventの位置は、このイベントが発生した時点での画面座標内のマウス・カーソルの位置を指定します。

    仮想デバイスを持たないマルチスクリーン環境では、カーソル位置はイニシエータ GraphicsConfigurationの座標系で指定されます。 イニシエータ GraphicsConfigurationは、現在のドラッグ操作のドラッグ・ジェスチャが認識されたComponentのGraphicsConfigurationです。 カーソル位置がイニシエータGraphicsConfigurationの境界の外側にある場合、報告される座標は、そのGraphicsConfigurationの境界の内側に収まるようにクリップされます。

    仮想デバイスを持つマルチスクリーン環境では、位置は対応する仮想座標体系で指定されます。 カーソル位置が仮想デバイスの境界の外側にある場合、通知される座標は仮想デバイスの境界の内側に収まるようにクリップされます。

    導入されたバージョン:
    1.2
    関連項目:
    直列化された形式

    • フィールドのサマリー

    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      DragSourceEvent​(DragSourceContext dsc)
      指定されたDragSourceContextを使用して、DragSourceEventを構築します。
      DragSourceEvent​(DragSourceContext dsc, int x, int y)
      指定されたDragSourceContext、およびカーソル位置の座標を使用して、DragSourceEventを構築します。

    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      DragSourceContext getDragSourceContext()
      このメソッドは、イベントを発生させたDragSourceContextを返します。
      Point getLocation()
      このメソッドは、このイベントが発生した時点での画面座標内のカーソル位置を示すPointを返します。このイベントに対してカーソル位置が指定されていない場合はnullを返します。
      int getX()
      このメソッドは、このイベントが発生した時点での画面座標のカーソル位置の水平座標を返し、このイベントにカーソル位置が指定されていない場合は0を返します。
      int getY()
      このメソッドは、このイベントが発生した時点での画面座標のカーソル位置の垂直座標を返し、このイベントにカーソル位置が指定されていない場合は0を返します。

    • コンストラクタの詳細

      • DragSourceEvent

        public DragSourceEvent​(DragSourceContext dsc)
        指定されたDragSourceContextを使用して、DragSourceEventを構築します。 このDragSourceEventでは座標が指定されないため、getLocationはこのイベントに対してnullを返します。
        パラメータ:
        dsc - DragSourceContext
        例外:
        IllegalArgumentException - dscがnullである場合。
        関連項目:
        getLocation()

      • DragSourceEvent

        public DragSourceEvent​(DragSourceContext dsc,
                       int x,
                       int y)
        指定されたDragSourceContext、およびカーソル位置の座標を使用して、DragSourceEventを構築します。
        パラメータ:
        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を返します。
        戻り値:
        カーソル位置の水平座標を示す整数値。カーソル位置が指定されていない場合は0
        導入されたバージョン:
        1.4

      • getY

        public int getY()
        このメソッドは、このイベントが発生した時点での画面座標のカーソル位置の垂直座標を返し、このイベントにカーソル位置が指定されていない場合は0を返します。
        戻り値:
        カーソル位置の垂直座標を示す整数値。カーソル位置が指定されていない場合は0
        導入されたバージョン:
        1.4