|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のパッケージ 次のパッケージ | フレームあり フレームなし |
参照:
説明
インタフェースの概要 | |
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 パッケージのさまざまなメソッドによってスローされます。 |
ドラッグ&ドロップ操作は、多くのグラフィカルユーザインタフェースシステムで見られる直接的な操作ジェスチャーで、GUI の表現要素に論理的に関連した 2 つのエンティティ間で情報を変換する機構を提供します。ドラッグ&ドロップは通常、適切な入力デバイスを使ったユーザの物理的ジェスチャーによって動作し、ナビゲーション中に後続のデータ変換で考えられる結果に関するユーザへの連続的なフィードバックを GUI の表現要素を介して可能にする機構と、後続のデータネゴシエーションとデータ変換を容易に行える機能の両方を提供します。
このパッケージは、Java でドラッグ&ドロップ操作を行うのに必要なクラスおよびインタフェースを定義します。ドラッグソースとドロップターゲットのクラス、およびドラッグされているデータを転送するためのイベントを定義します。このパッケージはまた、ドラッグ&ドロップ操作中にユーザに視覚的なフィードバックを提供する手段を備えています。
標準的なドラッグ&ドロップ操作は以下の状態に分解することができます (必ずしも連続していない)。
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
オブジェクトを介して受け取る
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のパッケージ 次のパッケージ | フレームあり フレームなし |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.