DragSourceDragEvent (Java Platform SE 8)

java.lang.Object
- java.util.EventObject
- - java.awt.dnd.DragSourceEvent
  - - java.awt.dnd.DragSourceDragEvent

すべての実装されたインタフェース:

Serializable
```
public class DragSourceDragEvent
extends DragSourceEvent
```
DragSourceDragEventは、DragSourceContextPeerからDragSourceContextを経由して、そのDragSourceContextとそれに関連付けられたDragSourceに登録されたDragSourceListenerに送られます。
DragSourceDragEventは、ドラッグ操作の現在の状態が反映されたターゲット・ドロップ・アクションとユーザー・ドロップ・アクションを報告します。
ターゲット・ドロップ・アクションは、現在のドロップ・ターゲットによって選択されたドロップ・アクションがドラッグ・ソースでサポートされている場合はこのドロップ・アクションを表すDnDConstantsのいずれか、このドロップ・アクションがドラッグ・ソースでサポートされていない場合はDnDConstants.ACTION_NONEです。
ユーザー・ドロップ・アクションは、ドラッグ・ソースでサポートされているドロップ・アクションと、ユーザーによって選択されたドロップ・アクションによって異なります。ユーザーは、ドラッグ操作中に修飾キーを押すことで、ドロップ・アクションを選択できます。
```
   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE
 
```
ユーザーがドロップ・アクションを選択した場合、ユーザー・ドロップ・アクションは、このドロップ・アクションがドラッグ・ソースでサポートされている場合は選択されたドロップ・アクションを表すDnDConstantsのいずれか、このドロップ・アクションがドラッグ・ソースでサポートされていない場合はDnDConstants.ACTION_NONEです。
ユーザーがドロップ・アクションを選択しない場合、ドラッグ・ソースでサポートされている一連のドロップ・アクションを表すDnDConstantsのセットからDnDConstants.ACTION_MOVE、DnDConstants.ACTION_COPY、DnDConstants.ACTION_LINKが順に検索され、ユーザー・ドロップ・アクションは最初に見つかった定数です。どの定数も見つからなかった場合、ユーザー・ドロップ・アクションはDnDConstants.ACTION_NONEです。
導入されたバージョン:

1.2

関連項目:

直列化された形式

フィールドのサマリー
- クラス java.util.EventObjectから継承されたフィールド
  source

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

コンストラクタ
コンストラクタ	説明
`DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)`	`DragSourceDragEvent`を構築します。
`DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)`	指定された`DragSourceContext`、ユーザー・ドロップ・アクション、ターゲット・ドロップ・アクション、修飾子、および座標を使用して、`DragSourceDragEvent`を構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`int`	`getDropAction()`	このメソッドは、ターゲット・ドロップ・アクション、およびドラッグ・ソースでサポートされる一連のドロップ・アクションの論理積を返します。
`int`	`getGestureModifiers()`	このメソッドは、ユーザーのジェスチャに関連付けられた入力デバイス修飾子の現在の状態を表す`int`を返します。
`int`	`getGestureModifiersEx()`	このメソッドは、ユーザーのジェスチャに関連付けられた、拡張された入力デバイス修飾子の現在の状態を表す`int`を返します。
`int`	`getTargetActions()`	このメソッドは、ターゲット・ドロップ・アクションを返します。
`int`	`getUserAction()`	このメソッドは、ユーザー・ドロップ・アクションを返します。

クラス java.awt.dnd.DragSourceEventから継承されたメソッド
getDragSourceContext, getLocation, getX, getY

クラス java.util.EventObjectから継承されたメソッド
getSource, toString

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - DragSourceDragEvent
```
public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers)
```
    DragSourceDragEventを構築します。このクラスは通常、クライアント・コードによって直接ではなく、DragSourceContextPeerによってインスタンス化されます。このDragSourceDragEventでは座標が指定されないため、getLocationはこのイベントに対してnullを返します。
    引数dropActionとactionには、1つのアクションを表すDnDConstantsのいずれかを指定するようにしてください。引数modifiersには、古いjava.awt.event.InputEvent.*_MASK定数のビット単位のマスクか、または拡張されたjava.awt.event.InputEvent.*_DOWN_MASK定数のビット単位のマスクのどちらかを指定するようにしてください。このコンストラクタは、無効なdropAction、action、およびmodifiersに対してどの例外もスローしません。
    
    パラメータ:
    
    dsc - このイベントの通知を管理するためのDragSourceContext。
    
    dropAction - ユーザー・ドロップ・アクション。
    
    action - ターゲット・ドロップ・アクション。
    
    modifiers - イベント発生時に押された修飾キー(Shift、Ctrl、Alt、メタ)。拡張された_DOWN_MASKまたは古い_MASK修飾子のどちらかを使用するべきですが、1つのイベントで両方のモデルを混在させてはいけません。拡張された修飾子の使用をお薦めします。
    
    例外:
    
    IllegalArgumentException - dscがnullである場合。
    
    関連項目:
    
    InputEvent、DragSourceEvent.getLocation()
  - DragSourceDragEvent
```
public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers,
                           int x,
                           int y)
```
    指定されたDragSourceContext、ユーザー・ドロップ・アクション、ターゲット・ドロップ・アクション、修飾子、および座標を使用して、DragSourceDragEventを構築します。
    引数dropActionとactionには、1つのアクションを表すDnDConstantsのいずれかを指定するようにしてください。引数modifiersには、古いjava.awt.event.InputEvent.*_MASK定数のビット単位のマスクか、または拡張されたjava.awt.event.InputEvent.*_DOWN_MASK定数のビット単位のマスクのどちらかを指定するようにしてください。このコンストラクタは、無効なdropAction、action、およびmodifiersに対してどの例外もスローしません。
    
    パラメータ:
    
    dsc - このイベントに関連付けられたDragSourceContext。
    
    dropAction - ユーザー・ドロップ・アクション。
    
    action - ターゲット・ドロップ・アクション。
    
    modifiers - イベント発生時に押された修飾キー(Shift、Ctrl、Alt、メタ)。拡張された_DOWN_MASKまたは古い_MASK修飾子のどちらかを使用するべきですが、1つのイベントで両方のモデルを混在させてはいけません。拡張された修飾子の使用をお薦めします。
    
    x - カーソル位置の水平座標
    
    y - カーソル位置の垂直座標
    
    例外:
    
    IllegalArgumentException - dscがnullである場合。
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    InputEvent
- メソッドの詳細
  - getTargetActions
```
public int getTargetActions()
```
    このメソッドは、ターゲット・ドロップ・アクションを返します。
    
    戻り値:
    
    ターゲット・ドロップ・アクション
  - getGestureModifiers
```
public int getGestureModifiers()
```
    このメソッドは、ユーザーのジェスチャに関連付けられた入力デバイス修飾子の現在の状態を表すintを返します。通常、これらはマウス・ボタンまたはキーボード修飾子となります。
    コンストラクタに渡されたmodifiersが無効である場合、このメソッドはそれを変更せずに返します。
    
    戻り値:
    
    入力デバイス修飾子の現在の状態
  - getGestureModifiersEx
```
public int getGestureModifiersEx()
```
    このメソッドは、ユーザーのジェスチャに関連付けられた、拡張された入力デバイス修飾子の現在の状態を表すintを返します。 InputEvent.getModifiersEx()を参照してください。
    コンストラクタに渡されたmodifiersが無効である場合、このメソッドはそれを変更せずに返します。
    
    戻り値:
    
    入力デバイスの拡張された修飾子の現在の状態
    
    導入されたバージョン:
    
    1.4
  - getUserAction
```
public int getUserAction()
```
    このメソッドは、ユーザー・ドロップ・アクションを返します。
    
    戻り値:
    
    ユーザー・ドロップ・アクション
  - getDropAction
```
public int getDropAction()
```
    このメソッドは、ターゲット・ドロップ・アクション、およびドラッグ・ソースでサポートされる一連のドロップ・アクションの論理積を返します。
    
    戻り値:
    
    ターゲット・ドロップ・アクション、およびドラッグ・ソースでサポートされる一連のドロップ・アクションの論理積

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスDragSourceDragEvent

フィールドのサマリー

クラス java.util.EventObjectから継承されたフィールド

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

メソッドのサマリー

クラス java.awt.dnd.DragSourceEventから継承されたメソッド

クラス java.util.EventObjectから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

DragSourceDragEvent

DragSourceDragEvent

メソッドの詳細

getTargetActions

getGestureModifiers

getGestureModifiersEx

getUserAction

getDropAction