DropTarget (Java Platform SE 8)

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, DropTargetListener dtl)` 自身を関連付ける`Component`、およびイベント処理を扱う`DropTargetListener`を使用して、`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を作成します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`addDropTargetListener(DropTargetListener dtl)` 新しい`DropTargetListener` (UNICAST SOURCE)を追加します。
`void`	`addNotify(java.awt.peer.ComponentPeer peer)` 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(java.awt.peer.ComponentPeer peer)` DropTargetとComponentの関連付けが解除されたことをそのDropTargetに通知します。通常、このメソッドはこのDropTargetに関連したComponentのjava.awt.Component.removeNotify()から呼び出され、ComponentPeerとそのComponentの関連付けが解除されたことをDropTargetに通知します。
`void`	`setActive(boolean isActive)` `true`の場合はDropTargetをアクティブに、`false`の場合は非アクティブに設定します。
`void`	`setComponent(Component c)` 注: このインタフェースは、 `component.setDropTarget(droptarget);` または `droptarget.setComponent(component);` の2つの方法のうちのどちらかでDropTargetと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)
```
    注: このインタフェースは、 component.setDropTarget(droptarget); または droptarget.setComponent(component); の2つの方法のうちのどちらかでDropTargetと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(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()
```
    自動スクロールをクリアします。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスDropTarget

ネストされたクラスのサマリー

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

DropTarget

DropTarget

DropTarget

DropTarget

DropTarget

メソッドの詳細

setComponent

getComponent

setDefaultActions

getDefaultActions

setActive

isActive

addDropTargetListener

removeDropTargetListener

dragEnter

dragOver

dropActionChanged

dragExit

drop

getFlavorMap

setFlavorMap

addNotify

removeNotify

getDropTargetContext

createDropTargetContext

createDropTargetAutoScroller

initializeAutoscrolling

updateAutoscroll

clearAutoscroll