|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.dnd.DragSourceContext
DragSourceContext
クラスは、ドラッグ&ドロッププロトコルのイニシエータ側を管理します。特に、DragSourceListener
と DragSourceMotionListener
へのドラッグイベント通知を管理し、ドラッグ操作のソースデータを表す Transferable
を提供します。
DragSourceContext
自体は DragSourceListener
および DragSourceMotionListener
インタフェースを実装していることに注意してください。これは、DragSource
で作成されたプラットフォームピア (DragSourceContextPeer
インスタンス) が、DragSourceContext
に対し、進行中の操作状態に変更があったことを通知できるようにするためです。これにより、DragSourceContext
はプラットフォームとドラッグ操作イニシエータで提供されたリスナーの間に、DragSourceContext
自体を挿入できます。
DragSourceListener
,
DragSourceMotionListener
,
直列化された形式フィールドの概要 | |
protected static int |
CHANGED
ユーザ操作が変更されたことを示す、updateCurrentCursor() で使用される int です。 |
protected static int |
DEFAULT
Cursor をデフォルト (ドロップなし) の Cursor に変更するよう指示する、updateCurrentCursor() で使用される int です。 |
protected static int |
ENTER
Cursor が DropTarget に入力されたことを示す、updateCurrentCursor() で使用される int です。 |
protected static int |
OVER
Cursor が DropTarget の上にあることを示す、updateCurrentCursor() で使用される int です。 |
コンストラクタの概要 | |
DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp,
DragGestureEvent trigger,
Cursor dragCursor,
Image dragImage,
Point offset,
Transferable t,
DragSourceListener dsl)
DragSource から呼び出され、このコンストラクタはこの Drag に DragSourceContextPeer を提供する新しい DragSourceContext を作成します。 |
メソッドの概要 | |
void |
addDragSourceListener(DragSourceListener dsl)
まだ 1 つも追加されていない場合、この DragSourceContext に DragSourceListener を追加します。 |
void |
dragDropEnd(DragSourceDropEvent dsde)
このメソッドは、この DragSourceContext 、および関連する DragSource で登録された DragSourceListener で dragDropEnd を呼び出し、指定された DragSourceDropEvent に渡します。 |
void |
dragEnter(DragSourceDragEvent dsde)
このメソッドは、この DragSourceContext 、および関連する DragSource で登録された DragSourceListener で dragEnter を呼び出し、指定された DragSourceDragEvent に渡します。 |
void |
dragExit(DragSourceEvent dse)
このメソッドは、この DragSourceContext 、および関連する DragSource で登録された DragSourceListener で dragExit を呼び出し、指定された DragSourceEvent に渡します。 |
void |
dragMouseMoved(DragSourceDragEvent dsde)
このメソッドは、この DragSourceContext に関連付けられた DragSource で登録された DragSourceMotionListener で dragMouseMoved を呼び出し、指定された DragSourceDragEvent に渡します。 |
void |
dragOver(DragSourceDragEvent dsde)
このメソッドは、この DragSourceContext 、および関連する DragSource で登録された DragSourceListener で dragOver を呼び出し、指定された DragSourceDragEvent に渡します。 |
void |
dropActionChanged(DragSourceDragEvent dsde)
このメソッドは、この DragSourceContext 、および関連する DragSource で登録された DragSourceListener で dropActionChanged を呼び出し、指定された DragSourceDragEvent に渡します。 |
Component |
getComponent()
このメソッドは、この DragSourceContext に関連した Component を返します。
|
Cursor |
getCursor()
このメソッドは現在のドラッグ Cursor を返します。
|
DragSource |
getDragSource()
このメソッドは、 DragSourceContext のインスタンスを生成した DragSource を返します。
|
int |
getSourceActions()
このメソッドは、この DragSourceContext |
Transferable |
getTransferable()
このメソッドは、この DragSourceContext に関連した Transferable を返します。
|
DragGestureEvent |
getTrigger()
このメソッドは、ドラッグを最初にトリガした DragGestureEvent を返します。
|
void |
removeDragSourceListener(DragSourceListener dsl)
このメソッドは、指定した DragSourceListener をこの DragSourceContext から削除します。
|
void |
setCursor(Cursor c)
このメソッドは現在のドラッグ Cursor を設定します。
|
void |
transferablesFlavorsChanged()
このメソッドは、Transferable の DataFlavors が変更されたことをピアに通知します。 |
protected void |
updateCurrentCursor(int dropOp,
int targetAct,
int status)
更新のためにカーソルを調べ、デフォルトを実装します。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
フィールドの詳細 |
protected static final int DEFAULT
Cursor
をデフォルト (ドロップなし) の Cursor
に変更するよう指示する、updateCurrentCursor() で使用される int
です。
protected static final int ENTER
Cursor
が DropTarget
に入力されたことを示す、updateCurrentCursor() で使用される int
です。
protected static final int OVER
Cursor
が DropTarget
の上にあることを示す、updateCurrentCursor() で使用される int
です。
protected static final int CHANGED
int
です。
コンストラクタの詳細 |
public DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point offset, Transferable t, DragSourceListener dsl)
DragSource
から呼び出され、このコンストラクタはこの Drag に DragSourceContextPeer
を提供する新しい DragSourceContext
を作成します。また、Drag をトリガした DragGestureEvent
、Drag に使用する初期の Cursor
、Drag の実行中に表示する (任意の) Image
、イベントをトリガした瞬間でのホットスポットからの Image
起点のオフセット、Transferable
サブジェクトデータ、およびドラッグ&ドロップ操作中に使用する DragSourceListener
も作成します。
DragSourceContextPeer
が null
の場合は、NullPointerException
がスローされます。
DragGestureEvent
が null
の場合は、NullPointerException
がスローされます。
Cursor
が null
の場合は、例外はスローされず、デフォルトのドラッグカーソルがこのドラッグ操作に使われます。
Image
が null
の場合、例外はスローされません。
Image が null
ではなく、オフセットが null
の場合は、NullPointerException
がスローされます。
Transferable
が null
の場合は、NullPointerException
がスローされます。
DragSourceListener
が null
の場合、例外はスローされません。
- パラメータ:
dscp
- このドラッグの DragSourceContextPeer
trigger
- トリガイベントdragCursor
- 初期の Cursor
dragImage
- ドラッグする Image
(または null
)offset
- トリガイベントの瞬間での、ホットスポットからのイメージ起点のオフセットt
- Transferable
dsl
- DragSourceListener
- 例外:
IllegalArgumentException
- トリガイベントに関連付けられた Component
が null
の場合
IllegalArgumentException
- トリガイベントの DragSource
が null
の場合
IllegalArgumentException
- トリガイベントのドラッグアクションが DnDConstants.ACTION_NONE
の場合
IllegalArgumentException
- トリガイベントに関連付けられた DragGestureRecognizer
のソースアクションが DnDConstants.ACTION_NONE
と等しい場合
NullPointerException
- dscp、trigger、または t が null の場合。または、dragImage が null ではなく、オフセットが null の場合
メソッドの詳細 |
public DragSource getDragSource()
DragSourceContext
のインスタンスを生成した DragSource
を返します。
DragSourceContext
のインスタンスを生成した DragSource
public Component getComponent()
DragSourceContext
に関連した Component
を返します。
Component
public DragGestureEvent getTrigger()
DragGestureEvent
を返します。
public int getSourceActions()
DragSourceContext に関連したドラッグ操作のドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants
のビット単位のマスクを返します。
- 戻り値:
- ドラッグソースでサポートされているドロップアクション
public void setCursor(Cursor c)
Cursor
を設定します。
c
- 表示する Cursor
。null
は禁止されていないが、このパラメータの許容値ではないpublic Cursor getCursor()
Cursor
を返します。
Cursor
public void addDragSourceListener(DragSourceListener dsl) throws TooManyListenersException
DragSourceContext
に DragSourceListener
を追加します。DragSourceListener
がすでに存在する場合、このメソッドは TooManyListenersException
をスローします。
dsl
- 追加対象の DragSourceListener
。null
は禁止されていないが、パラメータとして許可されていない
TooManyListenersException
DragSourceListener
- がすでに追加されている場合
TooManyListenersException
public void removeDragSourceListener(DragSourceListener dsl)
DragSourceListener
をこの DragSourceContext
から削除します。
dsl
- 削除対象の DragSourceListener
。null
は禁止されていないが、パラメータとして許可されていないことに注意public void transferablesFlavorsChanged()
public void dragEnter(DragSourceDragEvent dsde)
DragSourceContext
、および関連する DragSource
で登録された DragSourceListener
で dragEnter
を呼び出し、指定された DragSourceDragEvent
に渡します。
DragSourceListener
内の dragEnter
dsde
- DragSourceDragEvent
public void dragOver(DragSourceDragEvent dsde)
DragSourceContext
、および関連する DragSource
で登録された DragSourceListener
で dragOver
を呼び出し、指定された DragSourceDragEvent
に渡します。
DragSourceListener
内の dragOver
dsde
- DragSourceDragEvent
public void dragExit(DragSourceEvent dse)
DragSourceContext
、および関連する DragSource
で登録された DragSourceListener
で dragExit
を呼び出し、指定された DragSourceEvent
に渡します。
DragSourceListener
内の dragExit
dse
- DragSourceEvent
public void dropActionChanged(DragSourceDragEvent dsde)
DragSourceContext
、および関連する DragSource
で登録された DragSourceListener
で dropActionChanged
を呼び出し、指定された DragSourceDragEvent
に渡します。
DragSourceListener
内の dropActionChanged
dsde
- DragSourceDragEvent
public void dragDropEnd(DragSourceDropEvent dsde)
DragSourceContext
、および関連する DragSource
で登録された DragSourceListener
で dragDropEnd
を呼び出し、指定された DragSourceDropEvent
に渡します。
DragSourceListener
内の dragDropEnd
dsde
- DragSourceDropEvent
public void dragMouseMoved(DragSourceDragEvent dsde)
DragSourceContext
に関連付けられた DragSource
で登録された DragSourceMotionListener
で dragMouseMoved
を呼び出し、指定された DragSourceDragEvent
に渡します。
DragSourceMotionListener
内の dragMouseMoved
dsde
- DragSourceDragEvent
public Transferable getTransferable()
DragSourceContext
に関連した Transferable
を返します。
Transferable
protected void updateCurrentCursor(int dropOp, int targetAct, int status)
dropOp
- ユーザが現在選択した操作targetAct
- 現在のターゲットのサポート済みアクションstatus
- 定数
|
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.