DropTargetDragEvent (Java Platform SE 7)

java.lang.Object
- java.util.EventObject
- - java.awt.dnd.DropTargetEvent
  - - java.awt.dnd.DropTargetDragEvent

すべての実装されたインタフェース:

Serializable
```
public class DropTargetDragEvent
extends DropTargetEvent
```
DropTargetDragEvent は、その dragEnter() および dragOver() メソッドによって DropTargetListener に送られます。
DropTargetDragEvent は、ドラッグ操作の現在の状態が反映されたソースドロップアクションとユーザードロップアクションを報告します。
ソースドロップアクションは、このドラッグ操作のドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants のビット単位のマスクです。
ユーザードロップアクションは、ドラッグソースでサポートされているドロップアクションと、ユーザーによって選択されたドロップアクションによって異なります。ユーザーは、ドラッグ操作中に修飾キーを押すことで、ドロップアクションを選択できます。
```
   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE
 
```
ユーザーがドロップアクションを選択した場合、ユーザードロップアクションは、このドロップアクションがドラッグソースでサポートされている場合は選択されたドロップアクションを表す DnDConstants のいずれか、このドロップアクションがドラッグソースでサポートされていない場合は DnDConstants.ACTION_NONE です。
ユーザーがドロップアクションを選択しない場合、ドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants のセットから DnDConstants.ACTION_MOVE、DnDConstants.ACTION_COPY、DnDConstants.ACTION_LINK が順に検索され、ユーザードロップアクションは最初に見つかった定数です。どの定数も見つからなかった場合、ユーザードロップアクションは DnDConstants.ACTION_NONE です。
導入されたバージョン:

1.2

関連項目:
直列化された形式

フィールドのサマリー
- クラス java.awt.dnd.DropTargetEvent から継承されたフィールド
  context
- クラス java.util.EventObject から継承されたフィールド
  source

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

コンストラクタ
コンストラクタと説明
`DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)` この操作の `DropTargetContext`、`Component` の座標内の「ドラッグ」`Cursor` のホットスポットの位置、ユーザードロップアクション、およびソースドロップアクションを使用して、`DropTargetDragEvent` を構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`acceptDrag(int dragOperation)` ドラッグを受け入れます。
`DataFlavor[]`	`getCurrentDataFlavors()` このメソッドは、`DropTargetContext` から現在の `DataFlavor` を返します。
`List<DataFlavor>`	`getCurrentDataFlavorsAsList()` このメソッドは、現在の `DataFlavor` を `java.util.List` として返します。
`int`	`getDropAction()` このメソッドは、ユーザードロップアクションを返します。
`Point`	`getLocation()` このメソッドは、`Component` の座標内の `Cursor` の現在の位置を示す `Point` を返します。
`int`	`getSourceActions()` このメソッドは、ソースドロップアクションを返します。
`Transferable`	`getTransferable()` このメソッドは、現在のドラッグ操作に関連したデータを表す Transferable オブジェクトを返します。
`boolean`	`isDataFlavorSupported(DataFlavor df)` このメソッドは、指定された `DataFlavor` がサポートされているかどうかを示す `boolean` を返します。
`void`	`rejectDrag()` `dropAction` または使用可能な `DataFlavor` のタイプのどちらかを検査した結果としてドラッグを拒否します。

クラス java.awt.dnd.DropTargetEvent から継承されたメソッド
getDropTargetContext

クラス java.util.EventObject から継承されたメソッド
getSource, toString

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - DropTargetDragEvent
```
public DropTargetDragEvent(DropTargetContext dtc,
                   Point cursorLocn,
                   int dropAction,
                   int srcActions)
```
    この操作の DropTargetContext、Component の座標内の「ドラッグ」Cursor のホットスポットの位置、ユーザードロップアクション、およびソースドロップアクションを使用して、DropTargetDragEvent を構築します。
    
    パラメータ:
    dtc - この操作の DropTargetContext
    cursorLocn - Component 座標内の「ドラッグ」カーソルのホットスポットの位置
    dropAction - ユーザードロップアクション
    srcActions - ソースドロップアクション
    
    例外:
    
    NullPointerException - cursorLocn が null の場合
    
    IllegalArgumentException - dropAction が DnDConstants のいずれでもない場合。
    
    IllegalArgumentException - srcActions が DnDConstants のビット単位のマスクでない場合。
    
    IllegalArgumentException - dtc が null の場合。
- メソッドの詳細
  - getLocation
```
public Point getLocation()
```
    このメソッドは、Component の座標内の Cursor の現在の位置を示す Point を返します。
    
    戻り値:
    Component の座標内の現在のカーソル位置。
  - getCurrentDataFlavors
```
public DataFlavor[] getCurrentDataFlavors()
```
    このメソッドは、DropTargetContext から現在の DataFlavor を返します。
    
    戻り値:
    DropTargetContext からの現在の DataFlavor
  - getCurrentDataFlavorsAsList
```
public List<DataFlavor> getCurrentDataFlavorsAsList()
```
    このメソッドは、現在の DataFlavor を java.util.List として返します。
    
    戻り値:
    現在の DataFlavor の java.util.List
  - isDataFlavorSupported
```
public boolean isDataFlavorSupported(DataFlavor df)
```
    このメソッドは、指定された DataFlavor がサポートされているかどうかを示す boolean を返します。
    
    パラメータ:
    df - テストする DataFlavor
    
    戻り値:
    特定の DataFlavor がサポートされているかどうか
  - getSourceActions
```
public int getSourceActions()
```
    このメソッドは、ソースドロップアクションを返します。
    
    戻り値:
    ソースドロップアクション
  - getDropAction
```
public int getDropAction()
```
    このメソッドは、ユーザードロップアクションを返します。
    
    戻り値:
    ユーザードロップアクション
  - getTransferable
```
public Transferable getTransferable()
```
    このメソッドは、現在のドラッグ操作に関連したデータを表す Transferable オブジェクトを返します。
    
    戻り値:
    ドラッグ操作に関連する Transferable
    
    例外:
    
    InvalidDnDOperationException - ドラッグ操作に関連付けられたデータが使用できない場合
    導入されたバージョン:
    
    1.5
  - acceptDrag
```
public void acceptDrag(int dragOperation)
```
    ドラッグを受け入れます。このメソッドは、実装で srcActions から dropAction で表された、ユーザーによって選択された操作以外の操作を受け入れるようにしたい場合に、DropTargetListeners の dragEnter、dragOver、および dropActionChanged メソッドから呼び出すようにしてください。
    
    パラメータ:
    dragOperation - ターゲットによって受け入れられる操作
  - rejectDrag
```
public void rejectDrag()
```
    dropAction または使用可能な DataFlavor のタイプのどちらかを検査した結果としてドラッグを拒否します。

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

クラス DropTargetDragEvent

フィールドのサマリー

クラス java.awt.dnd.DropTargetEvent から継承されたフィールド

クラス java.util.EventObject から継承されたフィールド

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

メソッドのサマリー

クラス java.awt.dnd.DropTargetEvent から継承されたメソッド

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

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

コンストラクタの詳細

DropTargetDragEvent

メソッドの詳細

getLocation

getCurrentDataFlavors

getCurrentDataFlavorsAsList

isDataFlavorSupported

getSourceActions

getDropAction

getTransferable

acceptDrag

rejectDrag