JavaTM 2
Platform
Std. Ed. v1.4.0

java.awt.dnd
クラス DragSourceContext

java.lang.Object
  |
  +--java.awt.dnd.DragSourceContext
すべての実装インタフェース:
DragSourceListener, DragSourceMotionListener, EventListener, Serializable

public class DragSourceContext
extends Object
implements DragSourceListener, DragSourceMotionListener, Serializable

DragSourceContext クラスは、ドラッグ&ドロッププロトコルのイニシエータ側を管理します。特に、DragSourceListenerDragSourceMotionListener へのドラッグイベント通知を管理し、ドラッグ操作のソースデータを表す Transferable を提供します。

DragSourceContext 自体は DragSourceListener および DragSourceMotionListener インタフェースを実装していることに注意してください。これは、DragSource で作成されたプラットフォームピア (DragSourceContextPeer インスタンス) が、DragSourceContext に対し、進行中の操作状態に変更があったことを通知できるようにするためです。これにより、DragSourceContext はプラットフォームとドラッグ操作イニシエータで提供されたリスナーの間に、DragSourceContext 自体を挿入できます。

導入されたバージョン:
1.2
関連項目:
DragSourceListener, DragSourceMotionListener, 直列化された形式

フィールドの概要
protected static int CHANGED
          ユーザ操作が変更されたことを示す、updateCurrentCursor() で使用される int です。
protected static int DEFAULT
          Cursor をデフォルト (ドロップなし) の Cursor に変更するよう指示する、updateCurrentCursor() で使用される int です。
protected static int ENTER
          CursorDropTarget に入力されたことを示す、updateCurrentCursor() で使用される int です。
protected static int OVER
          CursorDropTarget の上にあることを示す、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 つも追加されていない場合、この DragSourceContextDragSourceListener を追加します。
 void dragDropEnd(DragSourceDropEvent dsde)
          このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdragDropEnd を呼び出し、指定された DragSourceDropEvent に渡します。
 void dragEnter(DragSourceDragEvent dsde)
          このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdragEnter を呼び出し、指定された DragSourceDragEvent に渡します。
 void dragExit(DragSourceEvent dse)
          このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdragExit を呼び出し、指定された DragSourceEvent に渡します。
 void dragMouseMoved(DragSourceDragEvent dsde)
          このメソッドは、この DragSourceContext に関連付けられた DragSource で登録された DragSourceMotionListenerdragMouseMoved を呼び出し、指定された DragSourceDragEvent に渡します。
 void dragOver(DragSourceDragEvent dsde)
          このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdragOver を呼び出し、指定された DragSourceDragEvent に渡します。
 void dropActionChanged(DragSourceDragEvent dsde)
          このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdropActionChanged を呼び出し、指定された DragSourceDragEvent に渡します。
 Component getComponent()
          このメソッドは、この DragSourceContext に関連した Component を返します。
 Cursor getCursor()
          このメソッドは現在のドラッグ Cursor を返します。
 DragSource getDragSource()
          このメソッドは、DragSourceContext のインスタンスを生成した DragSource を返します。
 int getSourceActions()
          このメソッドは、この DragSourceContext に関連したドラッグ操作のドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants のビット単位のマスクを返します。
 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
 

フィールドの詳細

DEFAULT

protected static final int DEFAULT
Cursor をデフォルト (ドロップなし) の Cursor に変更するよう指示する、updateCurrentCursor() で使用される int です。

関連項目:
定数フィールド値

ENTER

protected static final int ENTER
CursorDropTarget に入力されたことを示す、updateCurrentCursor() で使用される int です。

関連項目:
定数フィールド値

OVER

protected static final int OVER
CursorDropTarget の上にあることを示す、updateCurrentCursor() で使用される int です。

関連項目:
定数フィールド値

CHANGED

protected static final int CHANGED
ユーザ操作が変更されたことを示す、updateCurrentCursor() で使用される int です。

関連項目:
定数フィールド値
コンストラクタの詳細

DragSourceContext

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 も作成します。
DragSourceContextPeernull の場合は、NullPointerException がスローされます。
DragGestureEventnull の場合は、NullPointerException がスローされます。
Cursornull の場合は、例外はスローされず、デフォルトのドラッグカーソルがこのドラッグ操作に使われます。
Imagenull の場合、例外はスローされません。
Imagenull ではなく、オフセットが null の場合は、NullPointerException がスローされます。
Transferablenull の場合は、NullPointerException がスローされます。
DragSourceListenernull の場合、例外はスローされません。

パラメータ:
dscp - このドラッグの DragSourceContextPeer
trigger - トリガイベント
dragCursor - 初期の Cursor
dragImage - ドラッグする Image (または null)
offset - トリガイベントの瞬間での、ホットスポットからのイメージ起点のオフセット
t - Transferable
dsl - DragSourceListener
例外:
IllegalArgumentException - トリガイベントに関連付けられた Componentnull の場合
IllegalArgumentException - トリガイベントの DragSourcenull の場合
IllegalArgumentException - トリガイベントのドラッグアクションが DnDConstants.ACTION_NONE の場合
IllegalArgumentException - トリガイベントに関連付けられた DragGestureRecognizer のソースアクションが DnDConstants.ACTION_NONE と等しい場合
NullPointerException - dscp、trigger、または t が null の場合。または、dragImage が null ではなく、オフセットが null の場合
メソッドの詳細

getDragSource

public DragSource getDragSource()
このメソッドは、DragSourceContext のインスタンスを生成した DragSource を返します。

戻り値:
この DragSourceContext のインスタンスを生成した DragSource

getComponent

public Component getComponent()
このメソッドは、この DragSourceContext に関連した Component を返します。

戻り値:
ドラッグを開始させた Component

getTrigger

public DragGestureEvent getTrigger()
このメソッドは、ドラッグを最初にトリガした DragGestureEvent を返します。

戻り値:
ドラッグをトリガした Event

getSourceActions

public int getSourceActions()
このメソッドは、この DragSourceContext に関連したドラッグ操作のドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants のビット単位のマスクを返します。

戻り値:
ドラッグソースでサポートされているドロップアクション

setCursor

public void setCursor(Cursor c)
このメソッドは現在のドラッグ Cursor を設定します。

パラメータ:
c - 表示する Cursornull は禁止されていないが、このパラメータの許容値ではない

getCursor

public Cursor getCursor()
このメソッドは現在のドラッグ Cursor を返します。

戻り値:
現在のドラッグ Cursor

addDragSourceListener

public void addDragSourceListener(DragSourceListener dsl)
                           throws TooManyListenersException
まだ 1 つも追加されていない場合、この DragSourceContextDragSourceListener を追加します。DragSourceListener がすでに存在する場合、このメソッドは TooManyListenersException をスローします。

パラメータ:
dsl - 追加対象の DragSourceListenernull は禁止されていないが、パラメータとして許可されていない

例外:
TooManyListenersExceptionDragSourceListener - がすでに追加されている場合
TooManyListenersException

removeDragSourceListener

public void removeDragSourceListener(DragSourceListener dsl)
このメソッドは、指定した DragSourceListener をこの DragSourceContext から削除します。

パラメータ:
dsl - 削除対象の DragSourceListenernull は禁止されていないが、パラメータとして許可されていないことに注意

transferablesFlavorsChanged

public void transferablesFlavorsChanged()
このメソッドは、Transferable の DataFlavors が変更されたことをピアに通知します。


dragEnter

public void dragEnter(DragSourceDragEvent dsde)
このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdragEnter を呼び出し、指定された DragSourceDragEvent に渡します。

定義:
インタフェース DragSourceListener 内の dragEnter
パラメータ:
dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent dsde)
このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdragOver を呼び出し、指定された DragSourceDragEvent に渡します。

定義:
インタフェース DragSourceListener 内の dragOver
パラメータ:
dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent dse)
このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdragExit を呼び出し、指定された DragSourceEvent に渡します。

定義:
インタフェース DragSourceListener 内の dragExit
パラメータ:
dse - DragSourceEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent dsde)
このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdropActionChanged を呼び出し、指定された DragSourceDragEvent に渡します。

定義:
インタフェース DragSourceListener 内の dropActionChanged
パラメータ:
dsde - DragSourceDragEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent dsde)
このメソッドは、この DragSourceContext、および関連する DragSource で登録された DragSourceListenerdragDropEnd を呼び出し、指定された DragSourceDropEvent に渡します。

定義:
インタフェース DragSourceListener 内の dragDropEnd
パラメータ:
dsde - DragSourceDropEvent

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent dsde)
このメソッドは、この DragSourceContext に関連付けられた DragSource で登録された DragSourceMotionListenerdragMouseMoved を呼び出し、指定された DragSourceDragEvent に渡します。

定義:
インタフェース DragSourceMotionListener 内の dragMouseMoved
パラメータ:
dsde - DragSourceDragEvent
導入されたバージョン:
1.4

getTransferable

public Transferable getTransferable()
このメソッドは、この DragSourceContext に関連した Transferable を返します。

戻り値:
Transferable

updateCurrentCursor

protected void updateCurrentCursor(int dropOp,
                                   int targetAct,
                                   int status)
更新のためにカーソルを調べ、デフォルトを実装します。

パラメータ:
dropOp - ユーザが現在選択した操作
targetAct - 現在のターゲットのサポート済みアクション
status - 定数

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

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.