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, getYgetSource, toStringpublic 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 である場合。InputEventpublic 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.