java.awt.dnd
クラス DropTarget

java.lang.Object
  |
  +--java.awt.dnd.DropTarget

public class DropTarget

extends Object

implements DropTargetListener, Serializable

DropTarget は、ドラッグ＆ドロップ操作の間に Component がドロップを受け入れることを希望するときに、Component に関連付けられます。

導入されたバージョン:

JDK1.2

関連項目:

直列化された形式

内部クラスの概要

protected static class

DropTarget.DropTargetAutoScroller この protected の入れ子にされたクラスは自動スクロールを実装します。

コンストラクタの概要

DropTarget()
DropTarget を構築します。

DropTarget(Component c, DropTargetListener dtl)
DropTarget を構築します。

DropTarget(Component c, int ops, DropTargetListener dtl)
DropTarget を構築します。

DropTarget(Component c, int ops, DropTargetListener dtl, boolean act)
DropTarget を構築します。

DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm)
DropTarget を構築します。

メソッドの概要

void	addDropTargetListener(DropTargetListener dtl) 新しい DropTargetListener (UNICAST SOURCE) を追加します。
void	addNotify(java.awt.peer.ComponentPeer peer) DropTarget が Component に関連付けられていることをその DropTarget に通知します。
protected void	clearAutoscroll() 自動スクロールをクリアします。
protected DropTarget.DropTargetAutoScroller	createDropTargetAutoScroller(Component c, Point p) 組み込み自動スクローラを作成します。
protected DropTargetContext	createDropTargetContext() この DropTarget に関連付けられている DropTargetContext を作成します。
void	dragEnter(DropTargetDragEvent dtde) DropTarget は、登録されている DropTargetListener が取得する前に dragEnter() 通知を遮断します。
void	dragExit(DropTargetEvent dte) DropTarget は、登録されている DropTargetListener が取得する前に dragExit() 通知を遮断します。
void	dragOver(DropTargetDragEvent dtde) DropTarget は、登録されている DropTargetListener が取得する前に dragOver() 通知を遮断します。
void	drop(DropTargetDropEvent dtde) DropTarget は、登録されている DropTargetListener が取得する前に drop() 通知を遮断します。
void	dropActionChanged(DropTargetDragEvent dtde) DropTarget は、登録されている DropTargetListener が取得する前に dropActionChanged() 通知を遮断します。
Component	getComponent()
int	getDefaultActions()
DropTargetContext	getDropTargetContext()
FlavorMap	getFlavorMap()
protected void	initializeAutoscrolling(Point p) 自動スクロールを初期化します。
boolean	isActive()
void	removeDropTargetListener(DropTargetListener dtl) 現在の DropTargetListener (UNICAST SOURCE) を削除します。
void	removeNotify(java.awt.peer.ComponentPeer peer) DropTarget と Component の関連付けが解除されたことをその DropTarget に通知します。
void	setActive(boolean isActive) DropTarget をアクティブまたは非アクティブに設定します。
void	setComponent(Component c) 注: このインタフェースは、DropTarget と Component の安全な関連付けを次の 2 つの方法のどちらかで可能にする必要があります。
void	setDefaultActions(int ops) この DropTarget のデフォルトの許容アクションを設定します。
void	setFlavorMap(FlavorMap fm)
protected void	updateAutoscroll(Point dragCursorLocn) 現在のカーソルアイコンで自動スクロールを更新します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl,
                  boolean act,
                  FlavorMap fm)

DropTarget を構築します。

パラメータ:

c - この DropTarget が関連付けられる Component

ops - この DropTarget のデフォルトの許容アクション

dtl - この DropTarget の DropTargetListener

act - DropTarget がドロップを受け入れるかどうか

fm - 使用する flavorMap または null

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl,
                  boolean act)

DropTarget を構築します。

パラメータ:

c - この DropTarget が関連付けられる Component

ops - この DropTarget のデフォルトの許容アクション

dtl - この DropTarget の DropTargetListener

act - DropTarget がドロップを受け入れるかどうか

DropTarget

public DropTarget()

DropTarget を構築します。

DropTarget

public DropTarget(Component c,
                  DropTargetListener dtl)

DropTarget を構築します。

パラメータ:

c - この DropTarget が関連付けられる Component

dtl - この DropTarget の DropTargetListener

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl)

DropTarget を構築します。

パラメータ:

c - この DropTarget が関連付けられる Component

ops - この DropTarget のデフォルトの許容アクション

dtl - この DropTarget の DropTargetListener

メソッドの詳細

setComponent

public void setComponent(Component c)

注: このインタフェースは、DropTarget と Component の安全な関連付けを次の 2 つの方法のどちらかで可能にする必要があります。 component.setDropTarget(droptarget); または droptarget.setComponent(component); のどちらかです。 これを行うためには、呼び出し側は AWTPermission.setDropTarget を持つ必要があります。

パラメータ:

c - この DropTarget が関連付けられる新しい Component

getComponent

public Component getComponent()

戻り値:

現在の Component

setDefaultActions

public void setDefaultActions(int ops)

この DropTarget のデフォルトの許容アクションを設定します。

パラメータ:

ops - デフォルトアクション

関連項目:

DnDConstants

getDefaultActions

public int getDefaultActions()

戻り値:

現在のデフォルトアクション

setActive

public void setActive(boolean isActive)

DropTarget をアクティブまたは非アクティブに設定します。

パラメータ:

isActive -

isActive

public boolean isActive()

戻り値:

DropTarget がアクティブかどうか

addDropTargetListener

public void addDropTargetListener(DropTargetListener dtl)
                           throws TooManyListenersException

新しい DropTargetListener (UNICAST SOURCE) を追加します。

パラメータ:

dtl - 新しい DropTargetListener

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener dtl)

現在の DropTargetListener (UNICAST SOURCE) を削除します。

パラメータ:

dtl - 登録を解除する DropTargetListener

dragEnter

public void dragEnter(DropTargetDragEvent dtde)

DropTarget は、登録されている DropTargetListener が取得する前に dragEnter() 通知を遮断します。

定義:

インタフェース DropTargetListener 内の dragEnter

dragOver

public void dragOver(DropTargetDragEvent dtde)

DropTarget は、登録されている DropTargetListener が取得する前に dragOver() 通知を遮断します。

定義:

インタフェース DropTargetListener 内の dragOver

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

DropTarget は、登録されている DropTargetListener が取得する前に dropActionChanged() 通知を遮断します。

定義:

インタフェース DropTargetListener 内の dropActionChanged

dragExit

public void dragExit(DropTargetEvent dte)

DropTarget は、登録されている DropTargetListener が取得する前に dragExit() 通知を遮断します。

定義:

インタフェース DropTargetListener 内の dragExit

drop

public void drop(DropTargetDropEvent dtde)

DropTarget は、登録されている DropTargetListener が取得する前に drop() 通知を遮断します。

定義:

インタフェース DropTargetListener 内の drop

getFlavorMap

public FlavorMap getFlavorMap()

戻り値:

この DropTarget の FlavorMap

setFlavorMap

public void setFlavorMap(FlavorMap fm)

パラメータ:

set - 新しい flavormap、またはデフォルトの null

addNotify

public void addNotify(java.awt.peer.ComponentPeer peer)

DropTarget が Component に関連付けられていることをその DropTarget に通知します。 通常、このメソッドはこの DropTarget に関連付けられている Component の java.awt.Component.addNotify() から呼び出され、ComponentPeer がその Component に関連付けられていることを DropTarget に通知します。 ComponentPeer と Component との関連付けを DropTarget に通知する以外の目的でこのメソッドを呼び出すと、DnD システムが正常に動作しなくなることがあります。

パラメータ:

peer - 関連付けられている Component の Peer

removeNotify

public void removeNotify(java.awt.peer.ComponentPeer peer)

DropTarget と Component の関連付けが解除されたことをその DropTarget に通知します。 通常、このメソッドはこの DropTarget に関連付けられている Component の java.awt.Component.removeNotify() から呼び出され、ComponentPeer とその Component の関連付けが解除されたことを DropTarget に通知します。 ComponentPeer と Component の関連付けが解除されたことを DropTarget に通知する以外の目的でこのメソッドを呼び出すと、DnD システムが正常に動作しなくなることがあります。

パラメータ:

peer - 関連付けが解除される Component の Peer

getDropTargetContext

public DropTargetContext getDropTargetContext()

戻り値:

この DropTarget に関連付けられている DropTargetContext

createDropTargetContext

protected DropTargetContext createDropTargetContext()

この DropTarget に関連付けられている DropTargetContext を作成します。サブクラスはこのメソッドをオーバーライドして、独自の DropTargetContext サブクラスのインスタンスを生成できます。 通常、この呼び出しは、ドラッグ操作がこの DropTarget を検出したときにプラットフォームの DropTargetContextPeer によってだけ呼び出されます。ドラッグのないときに Context にアクセスすると、結果は保証されません。

createDropTargetAutoScroller

protected DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Component c,
                                                                         Point p)

組み込み自動スクローラを作成します。

initializeAutoscrolling

protected void initializeAutoscrolling(Point p)

自動スクロールを初期化します。

updateAutoscroll

protected void updateAutoscroll(Point dragCursorLocn)

現在のカーソルアイコンで自動スクロールを更新します。

clearAutoscroll

protected void clearAutoscroll()

自動スクロールをクリアします。