| 
 | 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 | DEFAULTCursorをデフォルト (ドロップなし) のCursorに変更するよう指示する、updateCurrentCursor() で使用されるintです。 | 
| protected static int | ENTERCursorがDropTargetに入力されたことを示す、updateCurrentCursor() で使用されるintです。 | 
| protected static int | OVERCursorが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 のインスタンスを生成した 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 は禁止されていないが、パラメータとして許可されていない
TooManyListenersExceptionDragSourceListenerTooManyListenersExceptionpublic 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.