|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.dnd.DragSource
DragSource
は、ドラッグ&ドロップ操作の開始を担当するエンティティで、次のようないくつかのシナリオで使用できます。
Component
のインスタンス、または Component
インスタンスに関連付けられているアプリケーション固有のオブジェクトごとに 1 つ。実装により異なる
DragSource
を取得した場合は、DragGestureRecognizer
も取得して、DragSource
を特定の Component
と関連付けます。
ユーザのジェスチャーの最初の実装、およびその後のドラッグ操作の開始は、通常 DragGestureRecognizer
が実装する実装 Component
が担当します。
ドラッグジェスチャーが発生すると、ユーザのナビゲーションジェスチャーの処理およびドラッグ&ドロッププロトコル通知の送達のため、DragSource
の startDrag() メソッドが呼び出されます。DragSource
は、どの時点でも現在のドラッグ&ドロップ操作として操作を 1 つだけ許可し、その操作が完了する時点まで、IllegalDnDOperationException
をスローすることによって他の startDrag() 要求を拒否します。
startDrag() メソッドは、createDragSourceContext() メソッドを呼び出して適切な DragSourceContext
をインスタンス化し、DragSourceContextPeer
をそれに関連付けます。
ドラッグ&ドロップシステムが何らかの理由でドラッグ操作を開始できない場合、startDrag() メソッドは java.awt.dnd.InvalidDnDOperationException
をスローしてその状態を通知します。この例外は通常、基礎になるプラットフォームシステムがドラッグを開始する状態にないか、あるいは指定されたパラメータが無効な場合にスローされます。
ドラッグ中は、ドラッグ操作の開始時点に転送元によって明らかにされた一連の操作は、その操作が完了するまで変更できません。DragSource
に関して、操作中はその操作は一定しています。
フィールドの概要 | |
static Cursor |
DefaultCopyDrop
コピー操作とともに使用して、ドロップが現在許可されていることを示すデフォルトの Cursor です。 |
static Cursor |
DefaultCopyNoDrop
コピー操作とともに使用して、ドロップが現在許可されていないことを示すデフォルトの Cursor です。 |
static Cursor |
DefaultLinkDrop
リンク操作とともに使用して、ドロップが現在許可されていることを示すデフォルトの Cursor です。 |
static Cursor |
DefaultLinkNoDrop
リンク操作とともに使用して、ドロップが現在許可されていないことを示すデフォルトの Cursor です。 |
static Cursor |
DefaultMoveDrop
移動操作とともに使用して、ドロップが現在許可されていることを示すデフォルトの Cursor です。 |
static Cursor |
DefaultMoveNoDrop
移動操作とともに使用して、ドロップが現在許可されていないことを示すデフォルトの Cursor です。 |
コンストラクタの概要 | |
DragSource()
新しい DragSource を構築します。 |
メソッドの概要 | |
void |
addDragSourceListener(DragSourceListener dsl)
指定された DragSourceListener をこの DragSource に追加し、この DragSource で開始されたドラッグ操作中のドラッグソースイベントを受信します。 |
void |
addDragSourceMotionListener(DragSourceMotionListener dsml)
指定された DragSourceMotionListener をこの DragSource に追加し、この DragSource で開始されたドラッグ操作中のドラッグモーションイベントを受信します。 |
DragGestureRecognizer |
createDefaultDragGestureRecognizer(Component c,
int actions,
DragGestureListener dgl)
DragGestureRecognizer のデフォルト抽象サブクラスを実装する新しい DragSourceRecognizer をこの DragSource に作成し、新しく作成されたオブジェクトに、指定された Component および DragGestureListener を設定します。 |
DragGestureRecognizer |
createDragGestureRecognizer(Class recognizerAbstractClass,
Component c,
int actions,
DragGestureListener dgl)
DragGestureRecognizer の指定された抽象サブクラスを実装する新しい DragGestureRecognizer を作成し、新しく作成されたオブジェクトに、指定された Component および DragGestureListener を設定します。
|
protected DragSourceContext |
createDragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp,
DragGestureEvent dgl,
Cursor dragCursor,
Image dragImage,
Point imageOffset,
Transferable t,
DragSourceListener dsl)
このドラッグを処理する DragSourceContext を作成します。
|
static DragSource |
getDefaultDragSource()
このメソッドは、基礎になるプラットフォームに関連した DragSource オブジェクトを返します。 |
DragSourceListener[] |
getDragSourceListeners()
この DragSource で登録したすべての DragSourceListener の配列を返します。 |
DragSourceMotionListener[] |
getDragSourceMotionListeners()
この DragSource で登録したすべての DragSourceMotionListener の配列を返します。 |
FlavorMap |
getFlavorMap()
このメソッドは、この DragSource の FlavorMap を返します。
|
EventListener[] |
getListeners(Class listenerType)
この DragSource の FooListener として現在登録されているすべてのオブジェクトの配列を返します。 |
static boolean |
isDragImageSupported()
このメソッドは、基本となるプラットフォームでドラッグ Image のサポートが可能かどうかを示す boolean を返します。
|
void |
removeDragSourceListener(DragSourceListener dsl)
指定された DragSourceListener をこの DragSource から削除します。 |
void |
removeDragSourceMotionListener(DragSourceMotionListener dsml)
指定された DragSourceMotionListener をこの DragSource から削除します。 |
void |
startDrag(DragGestureEvent trigger,
Cursor dragCursor,
Image dragImage,
Point dragOffset,
Transferable transferable,
DragSourceListener dsl)
ドラッグを開始した DragGestureEvent 、使用する初期 Cursor 、ドラッグする Image 、トリガの瞬間における Cursor のホットスポットからの Image 原点のオフセット、ドラッグの対象データ、および DragSourceListener を受けて、ドラッグを開始します。
|
void |
startDrag(DragGestureEvent trigger,
Cursor dragCursor,
Image dragImage,
Point imageOffset,
Transferable transferable,
DragSourceListener dsl,
FlavorMap flavorMap)
ドラッグを開始した DragGestureEvent 、使用する初期 Cursor 、ドラッグする Image 、トリガの瞬間における Cursor のホットスポットからの Image 原点のオフセット、ドラッグの Transferable 対象データ、DragSourceListener 、および FlavorMap を受けて、ドラッグを開始します。
|
void |
startDrag(DragGestureEvent trigger,
Cursor dragCursor,
Transferable transferable,
DragSourceListener dsl)
ドラッグを開始した DragGestureEvent 、使用する初期 Cursor ドラッグの Transferable 対象データ、および DragSourceListener を受けて、ドラッグを開始します。
|
void |
startDrag(DragGestureEvent trigger,
Cursor dragCursor,
Transferable transferable,
DragSourceListener dsl,
FlavorMap flavorMap)
ドラッグを開始した DragGestureEvent 、使用する初期 Cursor 、ドラッグの Transferable 対象データ、DragSourceListener 、および FlavorMap を受けて、ドラッグを開始します。
|
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
フィールドの詳細 |
public static final Cursor DefaultCopyDrop
Cursor
です。GraphicsEnvironment.isHeadless()
が true
を返す場合は、null
です。
GraphicsEnvironment.isHeadless()
public static final Cursor DefaultMoveDrop
Cursor
です。GraphicsEnvironment.isHeadless()
が true
を返す場合は、null
です。
GraphicsEnvironment.isHeadless()
public static final Cursor DefaultLinkDrop
Cursor
です。GraphicsEnvironment.isHeadless()
が true
を返す場合は、null
です。
GraphicsEnvironment.isHeadless()
public static final Cursor DefaultCopyNoDrop
Cursor
です。GraphicsEnvironment.isHeadless()
が true
を返す場合は、null
です。
GraphicsEnvironment.isHeadless()
public static final Cursor DefaultMoveNoDrop
Cursor
です。GraphicsEnvironment.isHeadless()
が true
を返す場合は、null
です。
GraphicsEnvironment.isHeadless()
public static final Cursor DefaultLinkNoDrop
Cursor
です。GraphicsEnvironment.isHeadless()
が true
を返す場合は、null
です。
GraphicsEnvironment.isHeadless()
コンストラクタの詳細 |
public DragSource() throws HeadlessException
DragSource
を構築します。
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
メソッドの詳細 |
public static DragSource getDefaultDragSource()
DragSource
オブジェクトを返します。
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
public static boolean isDragImageSupported()
Image
のサポートが可能かどうかを示す boolean
を返します。
public void startDrag(DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl, FlavorMap flavorMap) throws InvalidDnDOperationException
DragGestureEvent
、使用する初期 Cursor
、ドラッグする Image
、トリガの瞬間における Cursor
のホットスポットからの Image
原点のオフセット、ドラッグの Transferable
対象データ、DragSourceListener
、および FlavorMap
を受けて、ドラッグを開始します。
trigger
- ドラッグを開始させた DragGestureEvent
dragCursor
- 初期 Cursor
、またはデフォルトの場合 null
dragImage
- ドラッグするイメージ、または nullimageOffset
- トリガの瞬間における、Cursor
のホットスポットからの Image
原点のオフセットtransferable
- ドラッグの対象データdsl
- DragSourceListener
flavorMap
- 使用する FlavorMap
、または null
java.awt.dnd.InvalidDnDOperationException
- ドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を実行中にユーザがドラッグを開始しようとした場合
InvalidDnDOperationException
public void startDrag(DragGestureEvent trigger, Cursor dragCursor, Transferable transferable, DragSourceListener dsl, FlavorMap flavorMap) throws InvalidDnDOperationException
DragGestureEvent
、使用する初期 Cursor
、ドラッグの Transferable
対象データ、DragSourceListener
、および FlavorMap
を受けて、ドラッグを開始します。
trigger
- ドラッグを開始させた DragGestureEvent
dragCursor
- 初期 Cursor
、またはデフォルトの場合 null
transferable
- ドラッグの対象データdsl
- DragSourceListener
flavorMap
- 使用する FlavorMap
、または null
java.awt.dnd.InvalidDnDOperationException
- ドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を実行中にユーザがドラッグを開始しようとした場合
InvalidDnDOperationException
public void startDrag(DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point dragOffset, Transferable transferable, DragSourceListener dsl) throws InvalidDnDOperationException
DragGestureEvent
、使用する初期 Cursor
、ドラッグする Image
、トリガの瞬間における Cursor
のホットスポットからの Image
原点のオフセット、ドラッグの対象データ、および DragSourceListener
を受けて、ドラッグを開始します。
trigger
- ドラッグを開始させた DragGestureEvent
dragCursor
- 初期 Cursor
、またはデフォルトの場合 null
dragImage
- ドラッグする Image
または null
transferable
- ドラッグの対象データdsl
- DragSourceListener
java.awt.dnd.InvalidDnDOperationException
- ドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を実行中にユーザがドラッグを開始しようとした場合
InvalidDnDOperationException
public void startDrag(DragGestureEvent trigger, Cursor dragCursor, Transferable transferable, DragSourceListener dsl) throws InvalidDnDOperationException
DragGestureEvent
、使用する初期 Cursor
ドラッグの Transferable
対象データ、および DragSourceListener
を受けて、ドラッグを開始します。
trigger
- ドラッグを開始させた DragGestureEvent
dragCursor
- 初期 Cursor
、またはデフォルトの場合 null
transferable
- ドラッグの対象データdsl
- DragSourceListener
java.awt.dnd.InvalidDnDOperationException
- ドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を実行中にユーザがドラッグを開始しようとした場合
InvalidDnDOperationException
protected DragSourceContext createDragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent dgl, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable t, DragSourceListener dsl)
DragSourceContext
を作成します。
新しい DragSourceContext
サブクラスを組み込むには、DragSource
をサブクラス化し、このメソッドをオーバーライドします。
dscp
- このドラッグの DragSourceContextPeer
dragCursor
- 表示する初期 Cursor
dragImage
- ドラッグする Image
または null
imageOffset
- トリガの瞬間における、カーソルのホットスポットからの Image
原点のオフセットdsl
- DragSourceListener
DragSourceContext
public FlavorMap getFlavorMap()
DragSource
の FlavorMap
を返します。
DragSource
の FlavorMap
public DragGestureRecognizer createDragGestureRecognizer(Class recognizerAbstractClass, Component c, int actions, DragGestureListener dgl)
DragGestureRecognizer
の指定された抽象サブクラスを実装する新しい DragGestureRecognizer
を作成し、新しく作成されたオブジェクトに、指定された Component
および DragGestureListener
を設定します。
recognizerAbstractClass
- 要求された抽象型actions
- 許可されたソースドラッグアクションc
- Component
ターゲットdgl
- 通知する DragGestureListener
DragGestureRecognizer
。または Toolkit.createDragGestureRecognizer() メソッドが要求された DragGestureRecognizer
サブクラスに使用可能な実装を持たず null
を返した場合、null
public DragGestureRecognizer createDefaultDragGestureRecognizer(Component c, int actions, DragGestureListener dgl)
DragGestureRecognizer
のデフォルト抽象サブクラスを実装する新しい DragSourceRecognizer
をこの DragSource
に作成し、新しく作成されたオブジェクトに、指定された Component
および DragGestureListener
を設定します。この DragSource
の場合、デフォルトは MouseDragGestureRecognizer
です。
c
- レコグナイザの Component
ターゲットactions
- 許可されたソースアクションdgl
- 通知する DragGestureListener
DragGestureRecognizer
。または Toolkit.createDragGestureRecognizer() メソッドが要求された DragGestureRecognizer
サブクラスに使用可能な実装を持たず null
を返した場合、null
public void addDragSourceListener(DragSourceListener dsl)
DragSourceListener
をこの DragSource
に追加し、この DragSource
で開始されたドラッグ操作中のドラッグソースイベントを受信します。null
のリスナーが指定された場合は、何も処理は行われず、例外はスローされません。
dsl
- 追加する DragSourceListener
removeDragSourceListener(java.awt.dnd.DragSourceListener)
,
getDragSourceListeners()
public void removeDragSourceListener(DragSourceListener dsl)
DragSourceListener
をこの DragSource
から削除します。null
のリスナーが指定された場合は、何も処理は行われず、例外はスローされません。引数で指定されたリスナーが前にこの DragSource
に追加されていない場合は、何も処理は行われず、例外はスローされません。
dsl
- 削除する DragSourceListener
addDragSourceListener(java.awt.dnd.DragSourceListener)
,
getDragSourceListeners()
public DragSourceListener[] getDragSourceListeners()
DragSource
で登録したすべての DragSourceListener
の配列を返します。
DragSource
のすべての DragSourceListener
。該当するリスナーが現在登録されていない場合は、空の配列addDragSourceListener(java.awt.dnd.DragSourceListener)
,
removeDragSourceListener(java.awt.dnd.DragSourceListener)
public void addDragSourceMotionListener(DragSourceMotionListener dsml)
DragSourceMotionListener
をこの DragSource
に追加し、この DragSource
で開始されたドラッグ操作中のドラッグモーションイベントを受信します。null
のリスナーが指定された場合は、何も処理は行われず、例外はスローされません。
removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)
,
getDragSourceMotionListeners()
public void removeDragSourceMotionListener(DragSourceMotionListener dsml)
DragSourceMotionListener
をこの DragSource
から削除します。null
のリスナーが指定された場合は、何も処理は行われず、例外はスローされません。引数で指定されたリスナーが前にこの DragSource
に追加されていない場合は、何も処理は行われず、例外はスローされません。
dsml
- 削除する DragSourceMotionListener
addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)
,
getDragSourceMotionListeners()
public DragSourceMotionListener[] getDragSourceMotionListeners()
DragSource
で登録したすべての DragSourceMotionListener
の配列を返します。
DragSource
のすべての DragSourceMotionListener
。該当するリスナーが現在登録されていない場合は、空の配列addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)
,
removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)
public EventListener[] getListeners(Class listenerType)
DragSource
の FooListener
として現在登録されているすべてのオブジェクトの配列を返します。FooListener
は、addFooListener
メソッドを使用して登録します。
listenerType
- 要求されるリスナーのタイプ。このパラメータは、java.util.EventListener
から派生するインタフェースを指定する
DragSource
に FooListener
として登録されたすべてのオブジェクトの配列。該当するリスナーが追加されていない場合は、空の配列
ClassCastException
listenerType
- が java.util.EventListener
を実装するクラスまたはインタフェースを指定しない場合getDragSourceListeners()
,
getDragSourceMotionListeners()
|
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.