- java.lang.Object
-
- java.awt.dnd.DropTarget
-
- すべての実装されたインタフェース:
DropTargetListener
,Serializable
,EventListener
public class DropTarget extends Object implements DropTargetListener, Serializable
DropTarget
は、ドラッグ&ドロップ操作中にComponent
がドロップを受け入れようとするときに、そのComponent
に関連付けられます。各
DropTarget
はFlavorMap
に関連付けられます。 これ以降、デフォルトのFlavorMap
は、SystemFlavorMap.getDefaultFlavorMap()
によって返されたFlavorMap
を示します。- 導入されたバージョン:
- 1.2
- 関連項目:
- 直列化された形式
-
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 クラス 説明 protected static class
DropTarget.DropTargetAutoScroller
この保護されたネスト・クラスは、自動スクロールを実装します。
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 DropTarget()
DropTarget
を作成します。DropTarget(Component c, int ops, DropTargetListener dtl)
自身を関連付けるComponent
、サポートするデフォルトの許容アクションを表すint
、およびイベント処理を扱うDropTargetListener
を使用して、DropTarget
を作成します。DropTarget(Component c, int ops, DropTargetListener dtl, boolean act)
自身を関連付けるComponent
、サポートするデフォルトの許容アクションを表すint
、イベント処理を扱うDropTargetListener
、およびDropTarget
が現在ドロップを受け入れているかどうかを示すboolean
を使用して、DropTarget
を作成します。DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm)
自身を関連付けるComponent
、サポートするデフォルトの許容アクションを表すint
、イベント処理を扱うDropTargetListener
、DropTarget
が現在ドロップを受け入れているかどうかを示すboolean
、および使用するFlavorMap
(または、デフォルトのFlavorMap
の場合はnull)を使用して、新しいDropTargetを作成します。DropTarget(Component c, DropTargetListener dtl)
自身を関連付けるComponent
、およびイベント処理を扱うDropTargetListener
を使用して、DropTarget
を作成します。
-
メソッドのサマリー
修飾子と型 メソッド 説明 void
addDropTargetListener(DropTargetListener dtl)
新しいDropTargetListener
(UNICAST SOURCE)を追加します。void
addNotify()
DropTargetがComponentに関連付けられていることをそのDropTargetに通知します。通常、このメソッドはこのDropTargetに関連したComponentのjava.awt.Component.addNotify()から呼び出され、ComponentPeerがそのComponentに関連付けられていることをDropTargetに通知します。protected void
clearAutoscroll()
自動スクロールをクリアします。protected DropTarget.DropTargetAutoScroller
createDropTargetAutoScroller(Component c, Point p)
組込み自動スクローラを作成しますprotected DropTargetContext
createDropTargetContext()
このDropTargetに関連したDropTargetContextを作成します。void
dragEnter(DropTargetDragEvent dtde)
登録されたDropTargetListener
でdragEnter
を呼び出し、指定されたDropTargetDragEvent
をそれに渡します。void
dragExit(DropTargetEvent dte)
登録されたDropTargetListener
でdragExit
を呼び出し、指定されたDropTargetEvent
をそれに渡します。void
dragOver(DropTargetDragEvent dtde)
登録されたDropTargetListener
でdragOver
を呼び出し、指定されたDropTargetDragEvent
をそれに渡します。void
drop(DropTargetDropEvent dtde)
このDropTarget
がアクティブである場合は、登録されたDropTargetListener
でdrop
を呼び出し、指定されたDropTargetDropEvent
をそれに渡します。void
dropActionChanged(DropTargetDragEvent dtde)
登録されたDropTargetListener
でdropActionChanged
を呼び出し、指定されたDropTargetDragEvent
をそれに渡します。Component
getComponent()
このDropTarget
に関連付けられているComponent
を取得します。int
getDefaultActions()
このDropTarget
でサポートされている現在のアクションを表すint
を取得します。DropTargetContext
getDropTargetContext()
このDropTarget
に関連付けられているDropTargetContext
を取得します。FlavorMap
getFlavorMap()
このDropTarget
に関連付けられているFlavorMap
を取得します。protected void
initializeAutoscrolling(Point p)
自動スクロールを初期化しますboolean
isActive()
このDropTarget
が現在アクティブである(ドロップを受け入れる準備ができている)かどうかを報告します。void
removeDropTargetListener(DropTargetListener dtl)
現在のDropTargetListener
(UNICAST SOURCE)を削除します。void
removeNotify()
DropTargetとComponentの関連付けが解除されたことをそのDropTargetに通知します。通常、このメソッドはこのDropTargetに関連したComponentのjava.awt.Component.removeNotify()から呼び出され、ComponentPeerとそのComponentの関連付けが解除されたことをDropTargetに通知します。void
setActive(boolean isActive)
true
の場合はDropTargetをアクティブに、false
の場合は非アクティブに設定します。void
setComponent(Component c)
ノート: このインタフェースは、DropTargetとComponentの安全な関連付けを、次の2つの方法のいずれかで許可するために必要です:component.setDropTarget(droptarget);
またはdroptarget.setComponent(component);
void
setDefaultActions(int ops)
このDropTarget
のデフォルトの許容アクションを設定します。void
setFlavorMap(FlavorMap fm)
このDropTarget
に関連付けられたFlavorMap
を設定します。protected void
updateAutoscroll(Point dragCursorLocn)
現在のカーソル位置で自動スクロールを更新します
-
-
-
コンストラクタの詳細
-
DropTarget
public DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm) throws HeadlessException
自身を関連付けるComponent
、サポートするデフォルトの許容アクションを表すint
、イベント処理を扱うDropTargetListener
、DropTarget
が現在ドロップを受け入れているかどうかを示すboolean
、および使用するFlavorMap
(または、デフォルトのFlavorMap
の場合はnull)を使用して、新しいDropTargetを作成します。Componentは、使用可能な場合だけドロップを受け取ります。
- パラメータ:
c
- このDropTarget
が関連付けられているComponent
ops
- これのデフォルトの許容アクション:DropTarget
dtl
- このDropTarget
のDropTargetListener
act
-DropTarget
がドロップを受け入れているかどうかfm
- 使用するFlavorMap
。デフォルトのFlavorMap
の場合はnull- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 関連項目:
GraphicsEnvironment.isHeadless()
-
DropTarget
public DropTarget(Component c, int ops, DropTargetListener dtl, boolean act) throws HeadlessException
自身を関連付けるComponent
、サポートするデフォルトの許容アクションを表すint
、イベント処理を扱うDropTargetListener
、およびDropTarget
が現在ドロップを受け入れているかどうかを示すboolean
を使用して、DropTarget
を作成します。Componentは、使用可能な場合だけドロップを受け取ります。
- パラメータ:
c
- このDropTarget
が関連付けられているComponent
ops
- これのデフォルトの許容アクション:DropTarget
dtl
- このDropTarget
のDropTargetListener
act
-DropTarget
がドロップを受け入れているかどうか- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 関連項目:
GraphicsEnvironment.isHeadless()
-
DropTarget
public DropTarget() throws HeadlessException
DropTarget
を作成します。- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 関連項目:
GraphicsEnvironment.isHeadless()
-
DropTarget
public DropTarget(Component c, DropTargetListener dtl) throws HeadlessException
自身を関連付けるComponent
、およびイベント処理を扱うDropTargetListener
を使用して、DropTarget
を作成します。Componentは、使用可能な場合だけドロップを受け取ります。
- パラメータ:
c
- このDropTarget
が関連付けられているComponent
dtl
- このDropTarget
のDropTargetListener
- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 関連項目:
GraphicsEnvironment.isHeadless()
-
DropTarget
public DropTarget(Component c, int ops, DropTargetListener dtl) throws HeadlessException
自身を関連付けるComponent
、サポートするデフォルトの許容アクションを表すint
、およびイベント処理を扱うDropTargetListener
を使用して、DropTarget
を作成します。Componentは、使用可能な場合だけドロップを受け取ります。
- パラメータ:
c
- このDropTarget
が関連付けられているComponent
ops
- これのデフォルトの許容アクション:DropTarget
dtl
- このDropTarget
のDropTargetListener
- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 関連項目:
GraphicsEnvironment.isHeadless()
-
-
メソッドの詳細
-
setComponent
public void setComponent(Component c)
ノート: このインタフェースは、DropTargetとComponentの安全な関連付けを、次の2つの方法のいずれかで許可するために必要です:component.setDropTarget(droptarget);
またはdroptarget.setComponent(component);
Componentは、使用可能な場合だけドロップを受け取ります。
- パラメータ:
c
- このDropTarget
が関連付けられる新しいComponent
。
-
getComponent
public Component getComponent()
このDropTarget
に関連付けられているComponent
を取得します。- 戻り値:
- 現在の
Component
-
setDefaultActions
public void setDefaultActions(int ops)
このDropTarget
のデフォルトの許容アクションを設定します。- パラメータ:
ops
- デフォルトのアクション- 関連項目:
DnDConstants
-
getDefaultActions
public int getDefaultActions()
このDropTarget
でサポートされている現在のアクションを表すint
を取得します。- 戻り値:
- 現在のデフォルトのアクション
-
setActive
public void setActive(boolean isActive)
true
の場合はDropTargetをアクティブに、false
の場合は非アクティブに設定します。- パラメータ:
isActive
-DropTarget
をアクティブまたは非アクティブに設定する。
-
isActive
public boolean isActive()
このDropTarget
が現在アクティブである(ドロップを受け入れる準備ができている)かどうかを報告します。- 戻り値:
- アクティブな場合は
true
、そうでない場合はfalse
-
addDropTargetListener
public void addDropTargetListener(DropTargetListener dtl) throws TooManyListenersException
新しいDropTargetListener
(UNICAST SOURCE)を追加します。- パラメータ:
dtl
- 新しいDropTargetListener
- 例外:
TooManyListenersException
-DropTargetListener
がすでにこのDropTarget
に追加されている場合。
-
removeDropTargetListener
public void removeDropTargetListener(DropTargetListener dtl)
現在のDropTargetListener
(UNICAST SOURCE)を削除します。- パラメータ:
dtl
- 登録を解除するDropTargetListener。
-
dragEnter
public void dragEnter(DropTargetDragEvent dtde)
登録されたDropTargetListener
でdragEnter
を呼び出し、指定されたDropTargetDragEvent
をそれに渡します。 このDropTarget
がアクティブでない場合は、何の効果もありません。- 定義:
dragEnter
、インタフェース:DropTargetListener
- パラメータ:
dtde
-DropTargetDragEvent
- 例外:
NullPointerException
- このDropTarget
がアクティブであり、dtde
がnull
の場合- 関連項目:
isActive()
-
dragOver
public void dragOver(DropTargetDragEvent dtde)
登録されたDropTargetListener
でdragOver
を呼び出し、指定されたDropTargetDragEvent
をそれに渡します。 このDropTarget
がアクティブでない場合は、何の効果もありません。- 定義:
dragOver
、インタフェース:DropTargetListener
- パラメータ:
dtde
-DropTargetDragEvent
- 例外:
NullPointerException
- このDropTarget
がアクティブであり、dtde
がnull
の場合- 関連項目:
isActive()
-
dropActionChanged
public void dropActionChanged(DropTargetDragEvent dtde)
登録されたDropTargetListener
でdropActionChanged
を呼び出し、指定されたDropTargetDragEvent
をそれに渡します。 このDropTarget
がアクティブでない場合は、何の効果もありません。- 定義:
dropActionChanged
、インタフェース:DropTargetListener
- パラメータ:
dtde
-DropTargetDragEvent
- 例外:
NullPointerException
- このDropTarget
がアクティブであり、dtde
がnull
の場合- 関連項目:
isActive()
-
dragExit
public void dragExit(DropTargetEvent dte)
登録されたDropTargetListener
でdragExit
を呼び出し、指定されたDropTargetEvent
をそれに渡します。 このDropTarget
がアクティブでない場合は、何の効果もありません。このメソッド自体はnullのパラメータに対して例外をスローしませんが、リスナーの各メソッドによってスローされる例外に対しては例外をスローします。
- 定義:
dragExit
、インタフェース:DropTargetListener
- パラメータ:
dte
-DropTargetEvent
- 関連項目:
isActive()
-
drop
public void drop(DropTargetDropEvent dtde)
このDropTarget
がアクティブである場合は、登録されたDropTargetListener
でdrop
を呼び出し、指定されたDropTargetDropEvent
をそれに渡します。- 定義:
drop
、インタフェース:DropTargetListener
- パラメータ:
dtde
-DropTargetDropEvent
- 例外:
NullPointerException
-dtde
がnullで次のいずれか1つがtrueの場合: このDropTarget
がアクティブでないか、または登録されているDropTargetListener
が存在しない場合。- 関連項目:
isActive()
-
getFlavorMap
public FlavorMap getFlavorMap()
このDropTarget
に関連付けられているFlavorMap
を取得します。 このDropTarget
に対してFlavorMap
が設定されていない場合は、デフォルトのFlavorMap
に関連付けられます。- 戻り値:
- このDropTargetのFlavorMap
-
setFlavorMap
public void setFlavorMap(FlavorMap fm)
このDropTarget
に関連付けられたFlavorMap
を設定します。- パラメータ:
fm
- 新しいFlavorMap
。このDropTargetにデフォルトのFlavorMapを関連付ける場合はnull。
-
addNotify
public void addNotify()
DropTargetがComponentに関連付けられていることをそのDropTargetに通知します。通常、このメソッドはこのDropTargetに関連したComponentのjava.awt.Component.addNotify()から呼び出され、ComponentPeerがそのComponentに関連付けられていることをDropTargetに通知します。 ComponentPeerとComponentとの関連付けをこのDropTargetに通知する以外の目的でこのメソッドを呼び出すと、DnDシステムが正常に動作しなくなることがあります。
-
removeNotify
public void removeNotify()
DropTargetとComponentの関連付けが解除されたことをそのDropTargetに通知します。通常、このメソッドはこのDropTargetに関連したComponentのjava.awt.Component.removeNotify()から呼び出され、ComponentPeerとそのComponentの関連付けが解除されたことをDropTargetに通知します。 ComponentPeerとComponentとの関連付けが解除されたことをこのDropTargetに通知する以外の目的でこのメソッドを呼び出すと、DnDシステムが正常に動作しなくなることがあります。
-
getDropTargetContext
public DropTargetContext getDropTargetContext()
このDropTarget
に関連付けられているDropTargetContext
を取得します。- 戻り値:
- この
DropTarget
に関連付けられているDropTargetContext
。
-
createDropTargetContext
protected DropTargetContext createDropTargetContext()
このDropTargetに関連したDropTargetContextを作成します。 サブクラスは、このメソッドをオーバーライドして独自のDropTargetContextサブクラスをインスタンス化できます。 通常、この呼出しは、ドラッグ操作がこのDropTargetを検出したときにプラットフォームのDropTargetContextPeerによってだけ呼び出されます。 ドラッグのないときにContextにアクセスすると、結果は保証されません。- 戻り値:
- このDropTargetに関連付けられているDropTargetContext
-
createDropTargetAutoScroller
protected DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Component c, Point p)
組込み自動スクローラを作成します- パラメータ:
c
-Component
p
-Point
- 戻り値:
- 組み込みオートスクローラ
-
initializeAutoscrolling
protected void initializeAutoscrolling(Point p)
自動スクロールを初期化します- パラメータ:
p
-Point
-
updateAutoscroll
protected void updateAutoscroll(Point dragCursorLocn)
現在のカーソル位置で自動スクロールを更新します- パラメータ:
dragCursorLocn
-Point
-
clearAutoscroll
protected void clearAutoscroll()
自動スクロールをクリアします。
-
-