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 <DataFlavor >	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 를 구축합니다. 디폴트에서는 이 생성자 은, 타겟이 전송원과 같은 가상 머신에 없는 것이라고 봅니다. 즉 isLocalTransfer() 가 false 를 돌려줍니다.

파라미터:

dtc - 이 조작의 DropTargetContext

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

dropAction - 사용자 드롭 액션

srcActions - 소스 드롭 액션

예외:

NullPointerException - cursorLocn 가 null 의 경우

IllegalArgumentException - dropAction 가 DnDConstants 의 어떤 것도 아닌 경우

IllegalArgumentException - srcActions 가 DnDConstants 의 비트 단위의 마스크가 아닌 경우

IllegalArgumentException - dtc 가 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 - 소스 드롭 액션

isLocal - 전송원이 타겟과 같은 JVM 에 있는 경우는 true

예외:

NullPointerException - cursorLocn 가 null 의 경우

IllegalArgumentException - dropAction 가 DnDConstants 의 어떤 것도 아닌 경우

IllegalArgumentException - srcActions 가 DnDConstants 의 비트 단위의 마스크가 아닌 경우

IllegalArgumentException - dtc 가 null 의 경우

메소드의 상세

getLocation

public Point  getLocation()

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

반환값:

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

getCurrentDataFlavors

public DataFlavor [] getCurrentDataFlavors()

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

반환값:

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

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 에 있을지 어떨지