|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.util.EventObject | +--java.awt.dnd.DropTargetEvent | +--java.awt.dnd.DropTargetDropEvent
DropTargetDropEvent
は、DropTargetListener
の drop() メソッドを介して送られます。
DropTargetDropEvent
は、ドラッグ&ドロップ操作の現在の状態を反映した「ソースドロップアクション」と「ユーザドロップアクション」を通知します。
「ソースドロップアクション」は、このドラッグ&ドロップ操作のドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants
のビット単位のマスクです。
「ユーザドロップアクション」は、ドラッグソースでサポートされるドロップアクションと、ユーザが選択したドロップアクションによって異なります。ユーザは、ドラッグ操作中に修飾キーを押すことで、ドロップアクションを選択できます。
Ctrl + Shift -> ACTION_LINK Ctrl -> ACTION_COPY Shift -> ACTION_MOVEユーザがドロップアクションを選択した場合、「ユーザドロップアクション」は、選択されたドロップアクションがドラッグソースでサポートされていれば、そのドロップアクションを表す
DnDConstants
の 1 つです。そのドロップアクションがドラッグソースでサポートされていなければ、DnDConstants.ACTION_NONE
です。
ユーザがドロップアクションを選択しない場合は、ドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants
のセットで DnDConstants.ACTION_MOVE
、DnDConstants.ACTION_COPY
、DnDConstants.ACTION_LINK
が順に検索され、「ユーザドロップアクション」は最初に見つかる定数になります。定数が見つからない場合、「ユーザドロップアクション」は DnDConstants.ACTION_NONE
になります。
フィールドの概要 |
クラス java.awt.dnd.DropTargetEvent から継承したフィールド |
context |
クラス java.util.EventObject から継承したフィールド |
source |
コンストラクタの概要 | |
DropTargetDropEvent(DropTargetContext dtc,
Point cursorLocn,
int dropAction,
int srcActions)
この操作の DropTargetContext 、Component の座標にあるドラッグ Cursor のホットスポットの位置、現在選択されているユーザドロップアクション、および転送元でサポートされている現在の一連のアクションを指定して、DropTargetDropEvent を構築します。 |
|
DropTargetDropEvent(DropTargetContext dtc,
Point cursorLocn,
int dropAction,
int srcActions,
boolean isLocal)
この操作の DropTargetContext 、Component の座標にあるドラッグ Cursor ホットスポットの位置、現在ユーザが選択したドロップアクション、転送元でサポートされている現在の一連のアクション、そして転送元がターゲットと同じ JVM にあるかどうかを示す boolean で指定し、DropTargetEvent を構築します。
|
メソッドの概要 | |
void |
acceptDrop(int dropAction)
指定されたアクションを使って、ドロップを受け入れます。 |
void |
dropComplete(boolean success)
このメソッドは、ドロップ転送が完了したことを DragSource に通知します。
|
DataFlavor[] |
getCurrentDataFlavors()
このメソッドは、現在の DataFlavor を返します。 |
List |
getCurrentDataFlavorsAsList()
このメソッドは、現在有効な DataFlavor を java.util.List として返します。
|
int |
getDropAction()
このメソッドは、ユーザドロップアクションを返します。 |
Point |
getLocation()
このメソッドは、 Component の座標で Cursor の現在の位置を示す Point を返します。
|
int |
getSourceActions()
このメソッドは、ソースドロップアクションを返します。 |
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 |
コンストラクタの詳細 |
public DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
DropTargetContext
、Component
の座標にあるドラッグ Cursor
のホットスポットの位置、現在選択されているユーザドロップアクション、および転送元でサポートされている現在の一連のアクションを指定して、DropTargetDropEvent
を構築します。デフォルトではこのコンストラクタは、ターゲットが転送元と同じ仮想マシンにはないと見なします。つまり isLocalTransfer()
が false
を返します。
dtc
- この操作の DropTargetContext
cursorLocn
- Component
の座標での、「ドラッグ」カーソルホットスポットの位置dropAction
- ユーザドロップアクションsrcActions
- ソースドロップアクション
NullPointerException
- cursorLocn が null
の場合
IllegalArgumentException
dropAction
- が DnDConstants
のどれかでない場合
IllegalArgumentException
srcActions
- が DnDConstants
のビット単位のマスクでない場合
IllegalArgumentException
dtc
- が null
の場合public DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)
DropTargetContext
、Component
の座標にあるドラッグ Cursor
ホットスポットの位置、現在ユーザが選択したドロップアクション、転送元でサポートされている現在の一連のアクション、そして転送元がターゲットと同じ JVM にあるかどうかを示す boolean
で指定し、DropTargetEvent
を構築します。
dtc
- この操作の DropTargetContextcursorLocn
- Component の座標での、「ドラッグ」カーソルホットスポットの位置dropAction
- ユーザドロップアクションsrcActions
- ソースドロップアクション
NullPointerException
cursorLocn
- が null
の場合
IllegalArgumentException
dropAction
- が DnDConstants
のどれかでない場合
IllegalArgumentException
srcActions
- が DnDConstants
のビット単位のマスクでない場合
IllegalArgumentException
dtc
- が null
の場合メソッドの詳細 |
public Point getLocation()
Component
の座標で Cursor
の現在の位置を示す Point
を返します。
Cursor
位置public DataFlavor[] getCurrentDataFlavors()
public List getCurrentDataFlavorsAsList()
DataFlavor
を java.util.List
として返します。
public boolean isDataFlavorSupported(DataFlavor df)
DataFlavor
が転送元で有効かどうかを示す boolean
を返します。
df
- 判定対象の DataFlavor
public int getSourceActions()
public int getDropAction()
public Transferable getTransferable()
Transferable
オブジェクトを返します。
Transferable
public void acceptDrop(int dropAction)
dropAction
- 指定されたアクションpublic void rejectDrop()
public void dropComplete(boolean success)
DragSource
に通知します。
success
- ドロップ転送が完了したことを示す boolean
public boolean isLocalTransfer()
int
を返します。
|
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.