JavaTM 2
Platform
Std. Ed. v1.4.0

java.awt.dnd
クラス DragSourceDragEvent

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 の 1 つです。そのドロップアクションがドラッグソースでサポートされていない場合は、DnDConstants.ACTION_NONE です。

「ユーザドロップアクション」は、ドラッグソースでサポートされるドロップアクションと、ユーザが選択したドロップアクションによって異なります。ユーザは、ドラッグ操作中に修飾キーを押すことで、ドロップアクションを選択できます。

 
   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE
 
ユーザがドロップアクションを選択した場合、「ユーザドロップアクション」は、選択されたドロップアクションがドラッグソースでサポートされていれば、そのドロップアクションを表す DnDConstants の 1 つです。そのドロップアクションがドラッグソースでサポートされていなければ、DnDConstants.ACTION_NONE です。

ユーザがドロップアクションを選択しない場合は、ドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants のセットで DnDConstants.ACTION_MOVEDnDConstants.ACTION_COPYDnDConstants.ACTION_LINK が順に検索され、「ユーザドロップアクション」は最初に見つかる定数になります。定数が見つからない場合、「ユーザドロップアクション」は DnDConstants.ACTION_NONE になります。

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

フィールドの概要
 
クラス java.util.EventObject から継承したフィールド
source
 
コンストラクタの概要
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int actions, int modifiers)
          DragSourceDragEvent を構築します。
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int actions, int modifiers, int x, int y)
          DragSourceDragEvent を構築し、指定された DragSourceContext、ユーザドロップアクション、ターゲットドロップアクション、修飾子、および座標を指定します。
 
メソッドの概要
 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 actions,
                           int modifiers)
DragSourceDragEvent を構築します。このクラスは、通常、クライアントのコードから直接ではなく、DragSourceContextPeer によってインスタンスが生成されます。この DragSourceDragEvent の座標は指定されないため、getLocation はこのイベントに対して null を返します。

パラメータ:
dsc - このイベントに対する通知を管理するための DragSourceContext
dropAction - ユーザドロップアクション
actions - ターゲットドロップアクション
modifiers - イベント中に押された修飾キー (Shift、Ctrl、Alt、メタ)。拡張された _DOWN_MASK 修飾子または従来の _MASK 修飾子のどちらを使用するが、両方のモデルを 1 つのイベントで混用することはできない。拡張された修飾子の使用が推奨される
関連項目:
InputEvent, DragSourceEvent.getLocation()

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int actions,
                           int modifiers,
                           int x,
                           int y)
DragSourceDragEvent を構築し、指定された DragSourceContext、ユーザドロップアクション、ターゲットドロップアクション、修飾子、および座標を指定します。

パラメータ:
dsc - このイベントに関連した DragSourceContext
dropAction - ユーザドロップアクション
actions - ターゲットドロップアクション
modifiers - イベント中に押された修飾キー (Shift、Ctrl、Alt、メタ)。拡張された _DOWN_MASK 修飾子または従来の _MASK 修飾子のどちらを使用するが、両方のモデルを 1 つのイベントで混用することはできない。拡張された修飾子の使用が推奨される
x - カーソル位置の水平座標
y - カーソル位置の垂直座標
導入されたバージョン:
1.4
関連項目:
InputEvent
メソッドの詳細

getTargetActions

public int getTargetActions()
このメソッドは、ターゲットドロップアクションを返します。

戻り値:
ターゲットドロップアクション

getGestureModifiers

public int getGestureModifiers()
このメソッドは、ユーザのジェスチャーに関連した入力デバイス修飾子の現在の状態を表す int を返します。通常、これらはマウスボタンまたはキーボード修飾子となります。

戻り値:
入力デバイス修飾子の現在の状態

getGestureModifiersEx

public int getGestureModifiersEx()
このメソッドは、ユーザのジェスチャーに関連した入力デバイスの拡張された修飾子の現在の状態を表す int を返します。InputEvent.getModifiersEx() を参照してください。

戻り値:
入力デバイスの拡張された修飾子の現在の状態
導入されたバージョン:
1.4

getUserAction

public int getUserAction()
このメソッドは、ユーザドロップアクションを返します。

戻り値:
ユーザドロップアクション

getDropAction

public int getDropAction()
このメソッドは、ユーザドロップアクション、ターゲットドロップアクション、およびドラッグソースでサポートされる一連のドロップアクションの論理積を返します。

戻り値:
ユーザドロップアクション、ターゲットドロップアクション、およびドラッグソースでサポートされる一連のドロップアクションの論理積

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.