java.awt.dnd
클래스 DropTargetDragEvent

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 의 1 개입니다. 그 드롭 액션이 드래그 소스로 지원되어 있지 않으면,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)

드래그를 받아들입니다. 이 메소드는,dropAction 로 나타내진 사용자가 선택한 액션 이외의 srcActions 로부터 구현이 조작을 받아들이는 경우에,DropTargetListeners 의 dragEnter,dragOver, 및 dropActionChanged 메소드로부터 불려 갑니다.

파라미터:

dragOperation - 타겟이 받아들이는 조작

rejectDrag

public void rejectDrag()

dropAction 또는 유효한 DataFlavor 의 형태를 조사한 결과적으로 드래그를 거부합니다.