JavaTM 2 Platform
Standard Ed. 5.0

java.awt.dnd
クラス DropTargetAdapter

java.lang.Object
  上位を拡張 java.awt.dnd.DropTargetAdapter
すべての実装されたインタフェース:
DropTargetListener, EventListener

public abstract class DropTargetAdapter
extends Object
implements DropTargetListener

ドロップターゲットイベントを受け取るための抽象アダプタクラスです。このクラスのメソッドはすべて空です。このクラスは、リスナーオブジェクトの作成を容易にするためだけに提供されています。

DropTargetEvent リスナーを作成するには、このクラスを拡張して関連イベントに対するメソッドをオーバーライドします。DropTargetListener インタフェースを実装する場合は、その中のメソッドをすべて定義する必要があります。この抽象クラスは、drop(DropTargetDropEvent) 以外のすべてのメソッドについて空の実装を定義しているので、必要なイベント用のメソッドを定義するだけで済みます。少なくとも drop(DropTargetDropEvent) の実装は提供する必要があります。仕様上、ドロップを受け入れるか拒否するか、受け入れる場合はドロップが成功したかどうかを示す必要があるため、このメソッドの実装を空にすることはできません。 拡張したクラスを使ってリスナーオブジェクトを作成後、リスナーオブジェクトを DropTarget に登録します。ドラッグによって DropTarget のドロップサイトの操作可能な部分が入力、移動、または終了されたり、ドロップアクションが変更されたり、ドロップが発生したりすると、リスナーオブジェクトの関連するメソッドが呼び出され、そのメソッドに DropTargetEvent が渡されます。

DropTarget のドロップサイトの操作可能な部分とは、関連する Component のジオメトリの一部で、重なっている最上位のウィンドウや、関連するアクティブな DropTarget を持つ、Z-Order が高位である別の Component で隠されていない部分のことです。

ドラッグ時に、現在のドラッグ操作に関連するデータは、リスナーのメソッドに渡される DropTargetDragEvent インスタンスで getTransferable() を呼び出すことによって、取得できます。

DropTargetDragEvent インスタンスの getTransferable() は、各リスナーのメソッド内でのみ呼び出す必要があり、そのメソッドが戻る前に、返される Transferable からすべての必要なデータを取得する必要があることに注意してください。

導入されたバージョン:
1.4
関連項目:
DropTargetEvent, DropTargetListener

コンストラクタの概要
DropTargetAdapter()
           
 
メソッドの概要
 void dragEnter(DropTargetDragEvent dtde)
          ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分にマウスポインタが入ったときに呼び出されます。
 void dragExit(DropTargetEvent dte)
          ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分からマウスポインタが出たときに呼び出されます。
 void dragOver(DropTargetDragEvent dtde)
          ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分にマウスポインタがまだあるときに呼び出されます。
 void dropActionChanged(DropTargetDragEvent dtde)
          ユーザが現在のドロップジェスチャーを変更した場合に呼び出されます。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
インタフェース java.awt.dnd.DropTargetListener から継承されたメソッド
drop
 

コンストラクタの詳細

DropTargetAdapter

public DropTargetAdapter()
メソッドの詳細

dragEnter

public void dragEnter(DropTargetDragEvent dtde)
ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分にマウスポインタが入ったときに呼び出されます。

定義:
インタフェース DropTargetListener 内の dragEnter
パラメータ:
dtde - DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent dtde)
ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分にマウスポインタがまだあるときに呼び出されます。

定義:
インタフェース DropTargetListener 内の dragOver
パラメータ:
dtde - DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)
ユーザが現在のドロップジェスチャーを変更した場合に呼び出されます。

定義:
インタフェース DropTargetListener 内の dropActionChanged
パラメータ:
dtde - DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent dte)
ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分からマウスポインタが出たときに呼び出されます。

定義:
インタフェース DropTargetListener 内の dragExit
パラメータ:
dte - DropTargetEvent

JavaTM 2 Platform
Standard Ed. 5.0

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

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