JavaTM Platform
Standard Ed. 6

パッケージ 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 で登録された DragSourceListenerdragDropEnd メソッドに送られます。
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 階層をまたいで論理カーソルを動かし、GUI Component の幾何学的図形と重なります。その結果論理的「ドラッグ」カーソルが Component および関連の DropTarget に入り、横切り、その後離れる可能性があります。

DragSource オブジェクトはユーザーに「ドラッグオーバー」フィードバックを示します。通常の場合、論理カーソルに関連した GUI Cursor を動画化します。

DropTarget オブジェクトはユーザーに「ドラッグアンダー」フィードバックを示します。通常の場合、関連付けられた GUI Component の GUI Cursor にアニメーションを描画します。

フィードバック結果の判定、および必ずどちらかが発生するデータ変換の最終的な成功または失敗は、次のようにパラメータ化されます。

導入されたバージョン:
1.2

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。