|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
DropTargetListener
インタフェースは、対象の DropTarget
を含む DnD 操作の通知を DropTarget
クラスが提供するのに使うコールバックインタフェースです。このインタフェースのメソッドを実装すると、ドラッグ&ドロップ操作中に視覚的な「ドラッグアンダー」フィードバックをユーザに提供できます。
このインタフェースを実装してリスナーオブジェクトを作成後、リスナーオブジェクトを DropTarget
に登録します。ドラッグによって DropTarget
のドロップサイトの操作可能な部分が入力、移動、または終了されたり、ドロップアクションが変更されたり、ドロップが発生したりすると、リスナーオブジェクトの関連するメソッドが呼び出され、そのメソッドに DropTargetEvent
が渡されます。
DropTarget
のドロップサイトの操作可能な部分とは、関連する Component
のジオメトリの一部で、重なっている最上位のウィンドウや、関連するアクティブな DropTarget
を持つ、Z-Order が高位である別の Component
で隠されていない部分のことです。
メソッドの概要 | |
void |
dragEnter(DropTargetDragEvent dtde)
ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分にマウスポインタが入ったときに呼び出されます。 |
void |
dragExit(DropTargetEvent dte)
ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分からマウスポインタが出たときに呼び出されます。 |
void |
dragOver(DropTargetDragEvent dtde)
ドラッグ操作中に、リスナーに登録された DropTarget |
void |
drop(DropTargetDropEvent dtde)
リスナーに登録された DropTarget のドロップサイトの操作可能な部分へのドロップでドラッグ操作が終了したときに呼び出されます。
|
void |
dropActionChanged(DropTargetDragEvent dtde)
ユーザが現在のドロップジェスチャーを変更した場合に呼び出されます。 |
メソッドの詳細 |
public void dragEnter(DropTargetDragEvent dtde)
DropTarget
のドロップサイトの操作可能な部分にマウスポインタが入ったときに呼び出されます。
dtde
- DropTargetDragEvent
public void dragOver(DropTargetDragEvent dtde)
DropTarget のドロップサイトの操作可能な部分にマウスポインタがまだあるときに呼び出されます。
- パラメータ:
dtde
- DropTargetDragEvent
public void dropActionChanged(DropTargetDragEvent dtde)
dtde
- DropTargetDragEvent
public void dragExit(DropTargetEvent dte)
DropTarget
のドロップサイトの操作可能な部分からマウスポインタが出たときに呼び出されます。
dte
- DropTargetEvent
public void drop(DropTargetDropEvent dtde)
DropTarget
のドロップサイトの操作可能な部分へのドロップでドラッグ操作が終了したときに呼び出されます。
このメソッドは、ジェスチャーに関連したデータの確実な転送を担当します。DropTargetDropEvent
は、転送対象のデータオブジェクトを表す Transferable
オブジェクトを取得する手段を提供します。
DropTargetDropEvent
パラメータの acceptDrop(int dropAction) メソッドまたは rejectDrop() メソッドを使って、DropTargetListener
は このメソッドからドロップを受け入れるか、または拒否します。
acceptDrop() より前ではなく後に、DropTargetDropEvent
の getTransferable() メソッドが呼び出され、返された Transferable
の getTransferData() メソッドを使ってデータ変換が行われます。
ドロップの完了時には、このメソッドの実装は、DropTargetDropEvent
の dropComplete(boolean success) に該当の boolean
を渡すことによって、ドロップの成功または失敗を通知する必要があります。
注:DropTargetDropEvent
の dropComplete(boolean success) メソッドを呼び出す前に、データ転送が完了する必要があります。その後、データ転送がローカルの場合にだけ、つまり DropTargetDropEvent.isLocalTransfer()
が true
を返す場合にだけ、DropTargetDropEvent.getTransferable()
が返す Transferable
の getTransferData() メソッドの呼び出しの成功が保証されます。そうでない場合、呼び出しの動作は実装に依存します。
dtde
- DropTargetDropEvent
|
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.