|
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 - このドラッグの DragSourceContextPeertrigger - トリガイベントdragCursor - 初期の CursordragImage - ドラッグする Image (または null)offset - トリガイベントの瞬間での、ホットスポットからのイメージ起点のオフセットt - Transferabledsl - 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 のインスタンスを生成した DragSourcepublic Component getComponent()
DragSourceContext に関連した Component を返します。
Componentpublic 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 は禁止されていないが、パラメータとして許可されていない
TooManyListenersExceptionDragSourceListener - がすでに追加されている場合
TooManyListenersExceptionpublic void removeDragSourceListener(DragSourceListener dsl)
DragSourceListener をこの DragSourceContext から削除します。
dsl - 削除対象の DragSourceListener。null は禁止されていないが、パラメータとして許可されていないことに注意public void transferablesFlavorsChanged()
public void dragEnter(DragSourceDragEvent dsde)
DragSourceContext、および関連する DragSource で登録された DragSourceListener で dragEnter を呼び出し、指定された DragSourceDragEvent に渡します。
DragSourceListener 内の dragEnterdsde - DragSourceDragEventpublic void dragOver(DragSourceDragEvent dsde)
DragSourceContext、および関連する DragSource で登録された DragSourceListener で dragOver を呼び出し、指定された DragSourceDragEvent に渡します。
DragSourceListener 内の dragOverdsde - DragSourceDragEventpublic void dragExit(DragSourceEvent dse)
DragSourceContext、および関連する DragSource で登録された DragSourceListener で dragExit を呼び出し、指定された DragSourceEvent に渡します。
DragSourceListener 内の dragExitdse - DragSourceEventpublic void dropActionChanged(DragSourceDragEvent dsde)
DragSourceContext、および関連する DragSource で登録された DragSourceListener で dropActionChanged を呼び出し、指定された DragSourceDragEvent に渡します。
DragSourceListener 内の dropActionChangeddsde - DragSourceDragEventpublic void dragDropEnd(DragSourceDropEvent dsde)
DragSourceContext、および関連する DragSource で登録された DragSourceListener で dragDropEnd を呼び出し、指定された DragSourceDropEvent に渡します。
DragSourceListener 内の dragDropEnddsde - DragSourceDropEventpublic void dragMouseMoved(DragSourceDragEvent dsde)
DragSourceContext に関連付けられた DragSource で登録された DragSourceMotionListener で dragMouseMoved を呼び出し、指定された DragSourceDragEvent に渡します。
DragSourceMotionListener 内の dragMouseMoveddsde - DragSourceDragEventpublic 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.