JavaTM 2
Platform
Std. Ed. v1.4.0

java.awt.dnd
クラス DropTarget

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

public class DropTarget
extends Object
implements DropTargetListener, Serializable

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

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

入れ子クラスの概要
protected static class DropTarget.DropTargetAutoScroller
          この保護対象の入れ子になっているクラスは、自動スクロールを実装します。
 
コンストラクタの概要
DropTarget()
          DropTarget を構築します。
DropTarget(Component c, DropTargetListener dtl)
          指定された ComponentDropTarget を構築し、イベント処理を扱う DropTargetListener を関連付けます。
DropTarget(Component c, int ops, DropTargetListener dtl)
          指定された ComponentDropTarget を構築し、サポートするデフォルトの許容アクションを表す int、イベント処理を扱う DropTargetListener を関連付けます。
DropTarget(Component c, int ops, DropTargetListener dtl, boolean act)
          指定された ComponentDropTarget を構築し、サポートするデフォルトの許容アクションを表す int、イベント処理を扱う DropTargetListener、そして DropTarget が現在ドロップを受け入れるかどうかを示す boolean を関連付けます。
DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm)
          指定された Component に新しい DropTarget を構築し、サポートするデフォルトの許容アクションを表す int、イベント処理を扱う DropTargetListenerDropTarget が現在ドロップを受け入れるかどうかを示す boolean、そして使用する FlavorMap (または null) を関連付けます。
 
メソッドの概要
 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()
          このメソッドは、この DropTarget に関連した Component を返します。
 int getDefaultActions()
          このメソッドは、この DropTarget でサポートされた現在のアクションを表す int を返します。
 DropTargetContext getDropTargetContext()
          このメソッドは、この DropTarget に関連した DropTargetContext を返します。
 FlavorMap getFlavorMap()
          このメソッドは、この DropTarget に関連した FlavorMap を返します。
protected  void initializeAutoscrolling(Point p)
          自動スクロールを初期化します。
 boolean isActive()
          このメソッドは、この DropTarget が現在アクティブである (ドロップを受け入れる準備ができている) かどうかを示す boolean を返します。
 void removeDropTargetListener(DropTargetListener dtl)
          現在の DropTargetListener (UNICAST SOURCE) を削除します。
 void removeNotify(java.awt.peer.ComponentPeer peer)
          DropTarget と Component の関連付けが解除されたことをその DropTarget に通知します。
 void setActive(boolean isActive)
          true の場合は DropTarget をアクティブに、false の場合は非アクティブに設定します。
 void setComponent(Component c)
          注:このインタフェースは、DropTarget と Component の安全な関連付けを次の 2 つの方法のどちらかで可能にする必要があります。
 void setDefaultActions(int ops)
          この DropTarget のデフォルトの許容アクションを設定します。
 void setFlavorMap(FlavorMap fm)
          このメソッドは、この DropTarget に関連した FlavorMap を設定します。
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)
           throws HeadlessException
指定された Component に新しい DropTarget を構築し、サポートするデフォルトの許容アクションを表す int、イベント処理を扱う DropTargetListenerDropTarget が現在ドロップを受け入れるかどうかを示す boolean、そして使用する FlavorMap (または null) を関連付けます。

Component は、使用可能な場合だけドロップを受け取ります。

パラメータ:
c - この DropTarget が関連付けられる Component
ops - この DropTarget のデフォルトの許容アクション
dtl - この DropTargetDropTargetListener
act - DropTarget がドロップを受け入れるかどうか
fm - 使用する FlavorMap、または null
例外:
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:
GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl,
                  boolean act)
           throws HeadlessException
指定された ComponentDropTarget を構築し、サポートするデフォルトの許容アクションを表す int、イベント処理を扱う DropTargetListener、そして DropTarget が現在ドロップを受け入れるかどうかを示す boolean を関連付けます。

Component は、使用可能な場合だけドロップを受け取ります。

パラメータ:
c - この DropTarget が関連付けられる Component
ops - この DropTarget のデフォルトの許容アクション
dtl - この DropTargetDropTargetListener
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
指定された ComponentDropTarget を構築し、イベント処理を扱う DropTargetListener を関連付けます。

Component は、使用可能な場合だけドロップを受け取ります。

パラメータ:
c - この DropTarget が関連付けられる Component
dtl - この DropTargetDropTargetListener
例外:
HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
関連項目:
GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl)
           throws HeadlessException
指定された ComponentDropTarget を構築し、サポートするデフォルトの許容アクションを表す int、イベント処理を扱う DropTargetListener を関連付けます。

Component は、使用可能な場合だけドロップを受け取ります。

パラメータ:
c - この DropTarget が関連付けられる Component
ops - この DropTarget のデフォルトの許容アクション
dtl - この DropTargetDropTargetListener
例外:
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 が現在アクティブである (ドロップを受け入れる準備ができている) かどうかを示す boolean を返します。

戻り値:
DropTarget がアクティブかどうか

addDropTargetListener

public void addDropTargetListener(DropTargetListener dtl)
                           throws TooManyListenersException
新しい DropTargetListener (UNICAST SOURCE) を追加します。

パラメータ:
dtl - 新しい DropTargetListener

例外:
TooManyListenersExceptionDropTargetListener - がすでにこの DropTarget に追加されている場合
TooManyListenersException

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener dtl)
現在の DropTargetListener (UNICAST SOURCE) を削除します。

パラメータ:
dtl - 登録を解除する DropTargetListener

dragEnter

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

定義:
インタフェース DropTargetListener 内の dragEnter
パラメータ:
dtde - DropTargetDragEvent

dragOver

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

定義:
インタフェース DropTargetListener 内の dragOver
パラメータ:
dtde - DropTargetDragEvent

dropActionChanged

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

定義:
インタフェース DropTargetListener 内の dropActionChanged
パラメータ:
dtde - DropTargetDragEvent

dragExit

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

定義:
インタフェース DropTargetListener 内の dragExit
パラメータ:
dte - DropTargetEvent

drop

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

定義:
インタフェース DropTargetListener 内の drop
パラメータ:
dtde - DropTargetDropEvent

getFlavorMap

public FlavorMap getFlavorMap()
このメソッドは、この DropTarget に関連した FlavorMap を返します。

戻り値:
この DropTarget の FlavorMap

setFlavorMap

public void setFlavorMap(FlavorMap fm)
このメソッドは、この DropTarget に関連した FlavorMap を設定します。

パラメータ:
fm - 新しい 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 を返します。

戻り値:
この DropTarget に関連した DropTargetContext

createDropTargetContext

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


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()
自動スクロールをクリアします。


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.