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
です。
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()
このメソッドは、ユーザードロップアクションを返します。
|
getDragSourceContext, getLocation, getX, getY
getSource, toString
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()
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
である場合。InputEvent
public int getTargetActions()
public int getGestureModifiers()
int
を返します。通常、これらはマウスボタンまたはキーボード修飾子となります。
コンストラクタに渡された modifiers
が無効である場合、このメソッドはそれを変更せずに返します。
public int getGestureModifiersEx()
int
を返します。InputEvent.getModifiersEx()
を参照してください。
コンストラクタに渡された modifiers
が無効である場合、このメソッドはそれを変更せずに返します。
public int getUserAction()
public int getDropAction()
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.