java.awt.dnd
클래스 DropTargetDropEvent

java.lang.Object 
  |
  +--java.util.EventObject 
        |
        +--java.awt.dnd.DropTargetEvent 
              |
              +--java.awt.dnd.DropTargetDropEvent

모든 구현 인터페이스:

Serializable

public class DropTargetDropEvent

extends DropTargetEvent

DropTargetDropEvent 는 DropTargetListener 의 drop() 메소드를 개입시켜 보내집니다.

DropTargetDropEvent 는 드러그＆드롭 조작의 현재 상태를 반영한 「소스 드롭 액션」과「유저 드롭 액션」을 통지합니다.

「소스 드롭 액션」은 이 드러그＆드롭 조작의 드러그 소스로 서포트되고 있는 일련의 드롭 액션을 나타내는 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

생성자의 개요

DropTargetDropEvent (DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
이 조작의 DropTargetContext,Component 의 좌표에 있는 드러그 Cursor 의 핫 스포트의 위치, 현재 선택되고 있는 유저 드롭 액션, 및 전송원으로 서포트되고 있는 현재의 일련의 액션을 지정해,DropTargetDropEvent 를 구축합니다.

DropTargetDropEvent (DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)
이 조작의 DropTargetContext,Component 의 좌표에 있는 드러그 Cursor 핫 스포트의 위치, 현재 유저가 선택한 드롭 액션, 전송원으로 서포트되고 있는 현재의 일련의 액션, 그리고 전송원이 타겟과 같은 JVM 에 있을지 어떨지를 나타내는 boolean 로 지정해,DropTargetEvent 을 구축합니다.

메소드의 개요

void	acceptDrop (int dropAction) 지정된 액션을 사용해, 드롭을 받아들입니다.
void	dropComplete (boolean success) 이 메소드는 드롭 전송이 완료한 것을 DragSource 에 통지합니다.
DataFlavor []	getCurrentDataFlavors () 이 메소드는 현재의 DataFlavor 를 돌려줍니다.
List	getCurrentDataFlavorsAsList () 이 메소드는 현재 유효한 DataFlavor 를 java.util.List 로서 돌려줍니다.
int	getDropAction () 이 메소드는 유저 드롭 액션을 돌려줍니다.
Point	getLocation () 이 메소드는 Component 의 좌표로 Cursor 의 현재의 위치를 나타내는 Point 를 돌려줍니다.
int	getSourceActions () 이 메소드는 소스 드롭 액션을 돌려줍니다.
Transferable	getTransferable () 이 메소드는 드롭에 관련한 Transferable 오브젝트를 돌려줍니다.
boolean	isDataFlavorSupported (DataFlavor df) 이 메소드는 지정한 DataFlavor 가 전송원으로 유효한가 어떤가를 나타내는 boolean 를 돌려줍니다.
boolean	isLocalTransfer () 이 메소드는 전송원이 타겟과 같은 JVM 에 있을지 어떨지를 나타내는 int 를 돌려줍니다.
void	rejectDrop () 드롭을 거부합니다.

클래스 java.awt.dnd. DropTargetEvent 에서 상속받은 메소드

getDropTargetContext

클래스 java.util. EventObject 에서 상속받은 메소드

getSource , toString

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

생성자의 상세

DropTargetDropEvent

public DropTargetDropEvent(DropTargetContext  dtc,
                           Point  cursorLocn,
                           int dropAction,
                           int srcActions)

이 조작의 DropTargetContext,Component 의 좌표에 있는 드러그 Cursor 의 핫 스포트의 위치, 현재 선택되고 있는 유저 드롭 액션, 및 전송원으로 서포트되고 있는 현재의 일련의 액션을 지정해,DropTargetDropEvent 를 구축합니다. 디폴트에서는 이 constructor 은 타겟이 전송원과 같은 가상 머신에는 없다고 봅니다. 즉 isLocalTransfer() 가 false 를 돌려줍니다.

파라미터:

dtc - 이 조작의 DropTargetContext

cursorLocn - Component 의 좌표에서의, 「드러그」커서 핫 스포트의 위치

dropAction - 유저 드롭 액션

srcActions - 소스 드롭 액션

예외:

NullPointerException - cursorLocn 가 null 의 경우

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

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

IllegalArgumentExceptiondtc - 가 null 의 경우

DropTargetDropEvent

public DropTargetDropEvent(DropTargetContext  dtc,
                           Point  cursorLocn,
                           int dropAction,
                           int srcActions,
                           boolean isLocal)

이 조작의 DropTargetContext,Component 의 좌표에 있는 드러그 Cursor 핫 스포트의 위치, 현재 유저가 선택한 드롭 액션, 전송원으로 서포트되고 있는 현재의 일련의 액션, 그리고 전송원이 타겟과 같은 JVM 에 있을지 어떨지를 나타내는 boolean 로 지정해,DropTargetEvent 을 구축합니다.

파라미터:

dtc - 이 조작의 DropTargetContext

cursorLocn - Component 의 좌표에서의, 「드러그」커서 핫 스포트의 위치

dropAction - 유저 드롭 액션

srcActions - 소스 드롭 액션

예외:

NullPointerExceptioncursorLocn - 가 null 의 경우

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

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

IllegalArgumentExceptiondtc - 가 null 의 경우

메소드의 상세

getLocation

public Point  getLocation()

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

반환값:

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

getCurrentDataFlavors

public DataFlavor [] getCurrentDataFlavors()

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

반환값:

현재의 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()

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

반환값:

유저 드롭 액션

getTransferable

public Transferable  getTransferable()

이 메소드는 드롭에 관련한 Transferable 오브젝트를 돌려줍니다.

반환값:

드롭에 관련한 Transferable

acceptDrop

public void acceptDrop(int dropAction)

지정된 액션을 사용해, 드롭을 받아들입니다.

파라미터:

dropAction - 지정된 액션

rejectDrop

public void rejectDrop()

드롭을 거부합니다.

dropComplete

public void dropComplete(boolean success)

이 메소드는 드롭 전송이 완료한 것을 DragSource 에 통지합니다.

파라미터:

success - 드롭 전송이 완료한 것을 나타내는 boolean

isLocalTransfer

public boolean isLocalTransfer()

이 메소드는 전송원이 타겟과 같은 JVM 에 있을지 어떨지를 나타내는 int 를 돌려줍니다.

반환값:

Source 가 같은 JVM 에 있을지 어떨지