|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.util.EventObject | +--java.awt.dnd.DropTargetEvent | +--java.awt.dnd.DropTargetDragEvent
DropTargetDragEvent
は、その dragEnter() メソッドおよび dragOver() メソッドを介して DropTargetListener
に送られます。
DropTargetDragEvent
は、ドラッグ操作の現在の状態を反映した「ソースドロップアクション」と「ユーザドロップアクション」を通知します。
「ソースドロップアクション」は、このドラッグ操作のドラッグソースでサポートされている一連のドロップアクションを表す 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 |
コンストラクタの概要 | |
DropTargetDragEvent(DropTargetContext dtc,
Point cursorLocn,
int dropAction,
int srcActions)
この操作の DropTargetContext 、Component の座標にある「ドラッグ」Cursor のホットスポットの位置、ユーザドロップアクション、およびソースドロップアクションを指定して、DropTargetDragEvent を構築します。
|
メソッドの概要 | |
void |
acceptDrag(int dragOperation)
ドラッグを受け入れます。 |
DataFlavor[] |
getCurrentDataFlavors()
このメソッドは、この DropTargetContext から現在の DataFlavor を返します。
|
List |
getCurrentDataFlavorsAsList()
このメソッドは、現在の DataFlavor を java.util.List として返します。
|
int |
getDropAction()
このメソッドは、ユーザドロップアクションを返します。 |
Point |
getLocation()
このメソッドは、 Component の座標内で Cursor の現在の位置を示す Point を返します。
|
int |
getSourceActions()
このメソッドは、ソースドロップアクションを返します。 |
boolean |
isDataFlavorSupported(DataFlavor df)
このメソッドは、指定した DataFlavor がサポートされるかどうかを示す boolean を返します。
|
void |
rejectDrag()
dropAction または有効な DataFlavor のタイプを調べた結果としてドラッグを拒否します。 |
クラス java.awt.dnd.DropTargetEvent から継承したメソッド |
getDropTargetContext |
クラス java.util.EventObject から継承したメソッド |
getSource, toString |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
public DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
DropTargetContext
、Component
の座標にある「ドラッグ」Cursor
のホットスポットの位置、ユーザドロップアクション、およびソースドロップアクションを指定して、DropTargetDragEvent
を構築します。
dtc
- この操作の DropTargetContextcursorLocn
- Component の座標での「ドラッグ」カーソルのホットスポットの位置dropAction
- ユーザドロップアクションsrcActions
- ソースドロップアクション
NullPointerException
- cursorLocn が null の場合
IllegalArgumentException
dropAction
- が DnDConstants
のどれかでない場合
IllegalArgumentException
srcActions
- が DnDConstants
のビット単位のマスクでない場合
IllegalArgumentException
dtc
- が null
の場合メソッドの詳細 |
public Point getLocation()
Component
の座標内で Cursor
の現在の位置を示す Point
を返します。
Component
の座標での、現在のカーソルの位置public DataFlavor[] getCurrentDataFlavors()
DropTargetContext
から現在の DataFlavor
を返します。
public List getCurrentDataFlavorsAsList()
DataFlavor
を java.util.List
として返します。
DataFlavor
の java.util.List
public boolean isDataFlavorSupported(DataFlavor df)
DataFlavor
がサポートされるかどうかを示す boolean
を返します。
df
- 判定対象の DataFlavor
public int getSourceActions()
public int getDropAction()
public void acceptDrag(int dragOperation)
dropAction
で表されたユーザが選択したアクション以外の srcActions から実装が操作を受け入れる場合に、DropTargetListeners
の dragEnter
、dragOver
、および dropActionChanged
メソッドから呼び出されます。
dragOperation
- ターゲットが受け入れる操作public void rejectDrag()
dropAction
または有効な DataFlavor
のタイプを調べた結果としてドラッグを拒否します。
|
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.