モジュール java.desktop
パッケージ java.awt.dnd

クラスDropTarget

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)
    現在のカーソル位置で自動スクロールを更新します

    クラス 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、サポートするデフォルトの許容アクションを表す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()
      自動スクロールをクリアします。