JavaTM 2 Platform
Std. Ed. v1.3

java.awt.dnd
クラス DropTargetDropEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--java.awt.dnd.DropTargetEvent
              |
              +--java.awt.dnd.DropTargetDropEvent
すべての実装インタフェース:
Serializable

public class DropTargetDropEvent
extends DropTargetEvent

DropTargetDropEvent は、DropTargetListener の drop() メソッドを介して送られます。

導入されたバージョン:
1.2
関連項目:
直列化された形式

クラス java.awt.dnd.DropTargetEvent から継承したフィールド
context
 
クラス java.util.EventObject から継承したフィールド
source
 
コンストラクタの概要
DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
          この操作の DropTargetContextComponent の座標にあるドラッグ Cursor ホットスポットの位置、現在ユーザが選択したドロップアクション、そして転送元でサポートされている現在の一連のアクションで指定し、DropTargetDropEvent を構築します。
DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)
          この操作の DropTargetContextComponent の座標にあるドラッグ Cursor ホットスポットの位置、現在ユーザが選択したドロップアクション、転送元でサポートされている現在の一連のアクション、そして転送元がターゲットと同じ JVM にあるかどうかを示す boolean で指定し、DropTargetEvent を構築します。
 
メソッドの概要
 void acceptDrop(int dropAction)
          指定されたアクションを使って、ドロップを受け入れます。
 void dropComplete(boolean success)
          このメソッドは、ドロップ転送が完了したことを DragSource に通知します。
 DataFlavor[] getCurrentDataFlavors()
          このメソッドは、現在の DataFlavor を返します。
 List getCurrentDataFlavorsAsList()
          このメソッドは、現在有効な DataFlavorjava.util.List として返します。
 int getDropAction()
          このメソッドは、ドロップ時に転送元でサポートされたアクションを表す int を返します。
 Point getLocation()
          このメソッドは、Component の座標で Cursor の現在の位置を示す Point を返します。
 int getSourceActions()
          このメソッドは、転送元でサポートされたアクションを表す int を返します。
 Transferable getTransferable()
          このメソッドは、ドロップに関連した Transferable オブジェクトを返します。
 boolean isDataFlavorSupported(DataFlavor df)
          このメソッドは、指定した DataFlavor が転送元で有効かどうかを示す boolean を返します。
 boolean isLocalTransfer()
          このメソッドは、転送元がターゲットと同じ JVM にあるかどうかを示す int を返します。
 void rejectDrop()
          ドロップを拒否します。
 
クラス java.awt.dnd.DropTargetEvent から継承したメソッド
getDropTargetContext
 
クラス java.util.EventObject から継承したメソッド
getSource, toString
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

DropTargetDropEvent

public DropTargetDropEvent(DropTargetContext dtc,
                           Point cursorLocn,
                           int dropAction,
                           int srcActions)
この操作の DropTargetContextComponent の座標にあるドラッグ Cursor ホットスポットの位置、現在ユーザが選択したドロップアクション、そして転送元でサポートされている現在の一連のアクションで指定し、DropTargetDropEvent を構築します。デフォルトではこのコンストラクタは、ターゲットが転送元と同じ Virtual Machine にはないと見なされます。つまり isLocalTransfer()false を返します。

パラメータ:
dtc - この操作の DropTargetContext
cursorLocn - Component の座標での、「ドラッグ」カーソルホットスポットの位置
dropAction - 現在選択されているユーザのドロップアクション: DnDConstants にある COPY、MOVE、または LINK 定数
srcActions - 転送元でサポートされている現在の一連のアクション: DragSource で公開された、COPY、MOVE、または LINK の組み合わせの一部

例外:
NullPointerException - cursorLocn が null の場合
IllegalArgumentException - dropAction または srcActions が不正な値の場合、または dtc が null の場合

DropTargetDropEvent

public DropTargetDropEvent(DropTargetContext dtc,
                           Point cursorLocn,
                           int dropAction,
                           int srcActions,
                           boolean isLocal)
この操作の DropTargetContextComponent の座標にあるドラッグ Cursor ホットスポットの位置、現在ユーザが選択したドロップアクション、転送元でサポートされている現在の一連のアクション、そして転送元がターゲットと同じ JVM にあるかどうかを示す boolean で指定し、DropTargetEvent を構築します。

パラメータ:
dtc - この操作の DropTargetContext
cursorLocn - Component の座標での、「ドラッグ」カーソルホットスポットの位置
dropAction - 現在選択されているユーザのドロップアクション: DnDConstants にある COPY、MOVE、または LINK 定数
srcActions - 転送元でサポートされている現在の一連のアクション: DragSource で公開された、COPY、MOVE、または LINK の組み合わせの一部
isLocalTx - 転送元がターゲットと同じ JVM にある場合は true
メソッドの詳細

getLocation

public Point getLocation()
このメソッドは、Component の座標で Cursor の現在の位置を示す Point を返します。

戻り値:
Component の座標での、現在の Cursor 位置

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()
このメソッドは、現在の DataFlavor を返します。

戻り値:
現在の DataFlavor

getCurrentDataFlavorsAsList

public List getCurrentDataFlavorsAsList()
このメソッドは、現在有効な DataFlavorjava.util.List として返します。

戻り値:
現在の有効な DataFlavor の java.util.List

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)
このメソッドは、指定した DataFlavor が転送元で有効かどうかを示す boolean を返します。

パラメータ:
df - 判定対象の DataFlavor

戻り値:
指定された DataFlavor がソースで有効な場合

getSourceActions

public int getSourceActions()
このメソッドは、転送元でサポートされたアクションを表す int を返します。

戻り値:
転送元のアクション

getDropAction

public int getDropAction()
このメソッドは、ドロップ時に転送元でサポートされたアクションを表す int を返します。

戻り値:
転送元のアクション

getTransferable

public Transferable getTransferable()
このメソッドは、ドロップに関連した Transferable オブジェクトを返します。

戻り値:
ドロップに関連した Transferable

acceptDrop

public void acceptDrop(int dropAction)
指定されたアクションを使って、ドロップを受け入れます。

パラメータ:
dropAction - 指定されたアクション

rejectDrop

public void rejectDrop()
ドロップを拒否します。

dropComplete

public void dropComplete(boolean success)
このメソッドは、ドロップ転送が完了したことを DragSource に通知します。

パラメータ:
success - ドロップ転送が完了したことを示す boolean

isLocalTransfer

public boolean isLocalTransfer()
このメソッドは、転送元がターゲットと同じ JVM にあるかどうかを示す int を返します。

戻り値:
Source が同じ JVM にあるかどうか

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.