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	getCurrentDataFlavorsAsList () 이 메소드는 현재의 DataFlavor 를 java.util.List 로서 돌려줍니다.
int	getDropAction () 이 메소드는 유저 드롭 액션을 돌려줍니다.
Point	getLocation () 이 메소드는 Component 의 좌표내에서 Cursor 의 현재의 위치를 나타내는 Point 를 돌려줍니다.
int	getSourceActions () 이 메소드는 소스 드롭 액션을 돌려줍니다.
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 의 경우

IllegalArgumentExceptiondropAction - 이 DnDConstants 의 어떤 것인가 나오지 않는 경우

IllegalArgumentExceptionsrcActions - 이 DnDConstants 의 비트 단위의 마스크가 아닌 경우

IllegalArgumentExceptiondtc - 가 null 의 경우

메소드의 상세

getLocation

public Point  getLocation()

이 메소드는 Component 의 좌표내에서 Cursor 의 현재의 위치를 나타내는 Point 를 돌려줍니다.

반환값:

Component 의 좌표에서의, 현재의 커서의 위치

getCurrentDataFlavors

public DataFlavor [] getCurrentDataFlavors()

이 메소드는 이 DropTargetContext 로부터 현재의 DataFlavor 를 돌려줍니다.

반환값:

DropTargetContext 로부터의 현재의 DataFlavor

getCurrentDataFlavorsAsList

public List  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()

이 메소드는 유저 드롭 액션을 돌려줍니다.

반환값:

유저 드롭 액션

acceptDrag

public void acceptDrag(int dragOperation)

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

파라미터:

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

rejectDrag

public void rejectDrag()

dropAction 또는 유효한 DataFlavor 의 타입을 조사한 결과적으로 드러그를 거부합니다.