パッケージ java.awt.dnd
このパッケージは、Javaでドラッグ&ドロップ操作を行うのに必要なクラスおよびインタフェースを定義します。 ドラッグ・ソースとドロップ・ターゲットのクラス、およびドラッグされているデータを転送するためのイベントを定義します。 このパッケージはまた、ドラッグ&ドロップ操作中にユーザーに視覚的なフィード・バックを提供する手段を備えています。
標準的なドラッグ&ドロップ操作は次の状態に分解することができます(必ずしも連続していません)。
Transferable(転送可能になりうる)データのドラッグ&ドロップを開始するために、GUIの表現要素(Component)に関連付けられたDragSource(ドラッグ・ソース)が作成されます。Transferableデータ型を消費できる可能性のある、GUIの表現要素(Component)に関連付けられた1つ以上のDropTargetが生成または削除されます。DragGestureRecognizerがDragSourceから取得され、ユーザーのドラッグ開始ジェスチャをComponent上で追跡し識別するために、Componentと関連付けられます。- ユーザーが
Component上でドラッグ・ジェスチャを行うと、登録されたDragGestureRecognizerがそれを検出し、そのDragGestureListenerに通知します。注: このAPIでは、ドラッグ&ドロップ操作の開始要因がユーザーによる物理的なジェスチャであると一貫して記載していますが、これは、
DragSourceが適切に実装されている場合のプログラムによって開始されたDnD操作を除外するものではありません。 このパッケージには、マウス・デバイス・ジェスチャを認識するための抽象クラスMouseDragGestureRecognizerが含まれています。 その他の入力デバイスや、Componentクラスの特定のセマンティックスをサポートするために、プラットフォームによってその他のabstractサブクラスが提供されることがあります。 DragGestureListenerによって、DragSourceがユーザーの代わりにドラッグ&ドロップ操作を開始します。このとき、GUI Cursorが動画化されたり、操作の対象である項目のImageが描画されたりすることがあります。- ユーザー・ジェスチャが、
DropTargetが関連付けられているGUIのComponentの上を移動すると、サポートされる操作および関連するデータ型に基づいて、DragSourceは「ドラッグオーバー」フィード・バック効果を提供するために通知を受信し、DropTargetは「ドラッグ・アンダー」フィード・バック効果を提供するために通知を受け取ります。
ジェスチャ自体は、論理カーソルをGUI階層全体にわたって移動し、GUI Componentの幾何学的図形と交差します。これにより、論理的な「ドラッグ」カーソルがComponentとそれに関連付けられたDropTargetに入り、横切り、その後離れる可能性があります。
DragSourceオブジェクトはユーザーに「ドラッグオーバー」フィードバックを示します。通常の場合、論理カーソルに関連したGUI Cursorを動画化します。
DropTargetオブジェクトは、通常は関連付けられたGUI ComponentのGUI Cursorにアニメーションを描画することによって、「ドラッグ・アンダー」フィード・バックをユーザーに示します。
フィードバック結果の判定、および必ずどちらかが発生するデータ変換の最終的な成功または失敗は、次のようにパラメータ化されます。
- ユーザーが選択し、
DragSourceとDropTargetの両方がサポートする変換「操作」、つまりCopy、MoveまたはReference(link)によって、パラメータ化される。 DragSourceが提供するデータ型のセットと、DropTargetが包括できるデータ型のセットとの共通部分によって、パラメータ化される。- 通常はドロップの成功で終わるドラッグ操作をユーザーが終了するとき、
DragSourceおよびDropTargetは、DragSourceに関連した情報を含みその情報の型のネゴシエーションおよび変換となる通知を、Transferableオブジェクトを介して受け取る。
- 導入されたバージョン:
- 1.2
-
インタフェースのサマリー インタフェース 説明 Autoscroll DnD操作中、その時点ではユーザーに見えていないスクロール可能なGUIコントロールの領域に操作の対象をドロップしたい場合があります。DragGestureListener ドラッグ・ジェスチャ・イベントを受信するためのリスナー・インタフェース。DragSourceListener DragSourceListenerは、ドラッグ&ドロップ操作のオリジネータがユーザーのジェスチャの状態を追跡するためのイベント・インタフェースを定義し、ユーザーにドラッグ&ドロップ操作を通した適切な「ドラッグオーバー」フィード・バックを提供します。DragSourceMotionListener ドラッグ操作中のマウス・モーション・イベントを受け取るためのリスナー・インタフェースです。DropTargetListener DropTargetListenerインタフェースは、対象のDropTargetが関与するDnD操作の通知を提供するためにDropTargetクラスによって使用されるコールバック・インタフェースです。 -
クラスのサマリー クラス 説明 DnDConstants このクラスにはドラッグ&ドロップ操作が実行するアクションの形式を表す定数値があります。DragGestureEvent DragGestureEventは、特定のDragGestureRecognizerが、追跡しているComponentでプラットフォーム依存のドラッグ開始ジェスチャが発生したことを検出したときに、DragGestureListenerのdragGestureRecognized()メソッドに渡されます。DragGestureRecognizer DragGestureRecognizerは、プラットフォーム依存のドラッグ開始ジェスチャを識別するために特定のComponentに関連付けることのできる、プラットフォーム依存のリスナーを指定するための抽象基底クラスです。DragSource DragSourceは、ドラッグ&ドロップ操作の開始を担当するエンティティであり、いくつかのシナリオで使用される可能性があります。JVMごとに、そのJVMの寿命の間1デフォルト・インスタンスDragSourceAdapter ドラッグ・ソース・イベントを受け取る抽象アダプタ・クラスです。DragSourceContext DragSourceContextクラスは、ドラッグ&ドロップ・プロトコルのイニシエータ側の管理を担当します。DragSourceDragEvent DragSourceDragEventは、DragSourceContextPeerからDragSourceContextを経由して、そのDragSourceContextとそれに関連付けられたDragSourceに登録されたDragSourceListenerに送られます。DragSourceDropEvent DragSourceDropEventは、DragSourceContextPeerからDragSourceContextを経由して、そのDragSourceContextとそれに関連付けられたDragSourceに登録されたDragSourceListenerのdragDropEndメソッドに送られます。DragSourceEvent このクラスは、DragSourceDragEventとDragSourceDropEventの基底クラスです。DropTarget DropTargetは、ドラッグ&ドロップ操作中にComponentがドロップを受け入れようとするときに、そのComponentに関連付けられます。DropTarget.DropTargetAutoScroller この保護されたネスト・クラスは、自動スクロールを実装します。DropTargetAdapter ドロップ・ターゲット・イベントを受け取る抽象アダプタ・クラスです。DropTargetContext ドラッグ&ドロップ操作に関連付けられた論理カーソルが、DropTargetに関連付けられたComponentの可視幾何学的図形と重なった場合は常に、DropTargetContextが作成されます。DropTargetDragEvent DropTargetDragEventは、そのdragEnter()およびdragOver()メソッドによってDropTargetListenerに送られます。DropTargetDropEvent DropTargetDropEventは、DropTargetListenerのdrop()メソッドによって送られます。DropTargetEvent DropTargetEventは、DropTargetDragEventとDropTargetDropEventの両方の基底クラスです。MouseDragGestureRecognizer DragGestureRecognizerのこの抽象サブクラスは、マウス・ベースのジェスチャのDragGestureRecognizerを定義します。 -
例外のサマリー 例外 説明 InvalidDnDOperationException この例外は、java.awt.dndパッケージのさまざまなメソッドによってスローされます。