パッケージ java.awt.dnd

ドラッグ＆ドロップ操作は、多くのグラフィカルユーザインタフェースシステムで見られる直接的な操作ジェスチャーで、GUI の表現要素に論理的に関連した 2 つのエンティティ間で情報を変換する機構を提供します。

参照:
説明

インタフェースの概要

Autoscroll	DnD 操作中、その時点ではユーザに見えていないスクロール可能な GUI コントロールの領域に操作の対象をドロップしたい場合があります。
DragGestureListener	このインタフェースは DragGestureRecognizer をソースとし、その (サブ) クラスのオブジェクトがドラッグ開始ジェスチャーを検出したときに呼び出されます。
DragSourceListener	DragSourceListener は、ドラッグ＆ドロップ操作に関するオリジネータのイベントインタフェースを定義して、ユーザのジェスチャーの状態を監視したり、ドラッグ＆ドロップ操作全体の最適な「ドラッグオーバー」フィードバックをユーザに提供します。
DragSourceMotionListener	ドラッグ操作中のマウスモーションイベントを受け取るためのリスナーインタフェースです。
DropTargetListener	DropTargetListener インタフェースは、対象の DropTarget を含む DnD 操作の通知を DropTarget クラスが提供するのに使うコールバックインタフェースです。

クラスの概要

DnDConstants	このクラスにはドラッグ＆ドロップ操作が実行するアクションの形式を表す定数値があります。
DragGestureEvent	DragGestureEvent は、DragGestureListener の dragGestureRecognized() メソッドに渡されます。
DragGestureRecognizer	DragGestureRecognizer は、プラットフォーム依存のドラッグ開始ジェスチャーを識別するために、特定の Component に関連付けることができる、プラットフォーム依存のリスナーを指定するための抽象基底クラスです。
DragSource	DragSource は、ドラッグ＆ドロップ操作の開始を担当するエンティティで、次のようないくつかのシナリオで使用できます。
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	DropTargetContext は、ドラッグ＆ドロップ操作に関連した論理カーソルが、DropTarget に関連した Component の可視ジオメトリと重なるときに、いつも作成されます。
DropTargetDragEvent	DropTargetDragEvent は、その dragEnter() メソッドおよび dragOver() メソッドを介して DropTargetListener に送られます。
DropTargetDropEvent	DropTargetDropEvent は、DropTargetListener の drop() メソッドを介して送られます。
DropTargetEvent	DropTargetEvent は、DropTargetDragEvent および DropTargetDropEvent の基底クラスです。
MouseDragGestureRecognizer	DragGestureRecognizer のこの抽象サブクラスは、マウスベースのジェスチャーの DragGestureRecognizer を定義します。

例外の概要

InvalidDnDOperationException

この例外は、java.awt.dnd パッケージのさまざまなメソッドによってスローされます。

パッケージ java.awt.dnd の説明

ドラッグ＆ドロップ操作は、多くのグラフィカルユーザインタフェースシステムで見られる直接的な操作ジェスチャーで、GUI の表現要素に論理的に関連した 2 つのエンティティ間で情報を変換する機構を提供します。ドラッグ＆ドロップは通常、適切な入力デバイスを使ったユーザの物理的ジェスチャーによって動作し、ナビゲーション中に後続のデータ変換で考えられる結果に関するユーザへの連続的なフィードバックを GUI の表現要素を介して可能にする機構と、後続のデータネゴシエーションとデータ変換を容易に行える機能の両方を提供します。

このパッケージは、Java でドラッグ＆ドロップ操作を行うのに必要なクラスおよびインタフェースを定義します。ドラッグソースとドロップターゲットのクラス、およびドラッグされているデータを転送するためのイベントを定義します。このパッケージはまた、ドラッグ＆ドロップ操作中にユーザに視覚的なフィードバックを提供する手段を備えています。

標準的なドラッグ＆ドロップ操作は以下の状態に分解することができます (必ずしも連続していない)。

• GUI の表現要素 (Component) に関連した DragSource が発生し、Transferable と思われるデータのドラッグ＆ドロップが開始する

• Transferable データ型を使用できる可能性のある、GUI の表現要素 (Component) に関連した DropTarget が 1 つ以上現われるか、消失する

• DragGestureRecognizer が DragSource から取得され、ユーザのドラッグ開始ジェスチャーを Component 上で追跡し識別するために、Component と関連付けられる

• ユーザが Component 上でドラッグジェスチャーを行うと、登録された DragGestureRecognizer がそれを検出し、その DragGestureListener を通知する

  注: この API は一貫して、ユーザによる物理的ジェスチャーであるドラッグ＆ドロップ操作の刺激に関連しますが、このことは、DragSource の実装が適切な場合にプログラム上で行われる DnD 操作を排除するものではありません。このパッケージは、マウスデバイスのジェスチャーを識別する抽象クラス MouseDragGestureRecognizer を格納しています。他の入力デバイスまたは特定の Component クラスのセマンティクスをサポートするために、プラットフォームによって他の抽象クラスが提供されることがあります。

• 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