java.awt.dnd
인터페이스 DropTargetListener

모든 슈퍼 인터페이스:

EventListener

알려진 구현 클래스 목록:

DropTarget, DropTargetAdapter

public interface DropTargetListener
extends EventListener 

DropTargetListener인터페이스는 대상의 DropTarget을 포함한 DnD 조작의 통지를 DropTarget 클래스가 제공하는데 사용하는 콜백 인터페이스입니다. 이 인터페이스의 메서드를 구현하면, 드래그＆드롭 조작중에 시각적인 「드래그 언더」피드백을 사용자에 게 제공할 수 있습니다.

이 인터페이스를 구현해 리스너 객체를 작성 후, 리스너 객체를 DropTarget에 등록합니다. 드래그에 의해 DropTarget 드롭 사이트의 조작 가능한 부분이 입력, 이동, 또는 종료되거나 드롭 액션이 변경되거나 드롭이 발생하거나 하면, 리스너 객체의 관련된 메서드가 불려가 그 메서드에 DropTargetEvent이 건네받습니다.

DropTarget 드롭 사이트의 조작 가능한 부분이란 관련된 Component 지오메트리의 일부로 겹치고 있는 최상정도의 윈도우나, 관련된 활성화된 DropTarget을 가지는 Z-Order가 고위인 다른 Component로 숨겨지지 않은 부분입니다.

드래그 시에 현재의 드래그 조작에 관련된 데이터는 리스너의 메서드에게 건네지는 DropTargetDragEvent인스턴스로 getTransferable()를 호출하는 것에의해 취득할 수 있습니다.

DropTargetDragEvent인스턴스의 getTransferable()는 각 리스너의 메서드내에서만 호출할 필요가 있어, 그 메서드가 돌아오기 전에 리턴된 Transferable로 부터 모든 필요한 데이터를 취득할 필요가 있는 것에 주의해 주세요.

도입된 버전 :

1.2

메서드 개요

void	dragEnter (DropTargetDragEvent dtde) 드래그 조작중에 리스너에게 등록된 DropTarget 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 들어갔을 때에 호출합니다.
void	dragExit (DropTargetEvent dte) 드래그 조작중에 리스너에게 등록된 DropTarget 드롭 사이트의 조작 가능한 부분으로부터 마우스 포인터가 나왔을 때에 호출합니다.
void	dragOver (DropTargetDragEvent dtde) 드래그 조작중에 리스너에게 등록된 DropTarget 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 아직 있을 때 호출합니다.
void	drop (DropTargetDropEvent dtde) 리스너에게 등록된 DropTarget 드롭 사이트의 조작 가능한 부분에의 드롭으로 드래그 조작이 종료했을 때에 호출합니다.
void	dropActionChanged (DropTargetDragEvent dtde) 사용자가 현재의 드롭 제스추어를 변경했을 경우에 호출합니다.

메서드의 상세

dragEnter

void dragEnter(DropTargetDragEvent  dtde)

드래그 조작중에 리스너에게 등록된 DropTarget 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 들어갔을 때에 호출합니다.

파라미터:

dtde - DropTargetDragEvent

dragOver

void dragOver(DropTargetDragEvent  dtde)

드래그 조작중에 리스너에게 등록된 DropTarget 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 아직 있을 때 호출합니다.

파라미터:

dtde - DropTargetDragEvent

dropActionChanged

void dropActionChanged(DropTargetDragEvent  dtde)

사용자가 현재의 드롭 제스추어를 변경했을 경우에 호출합니다.

파라미터:

dtde - DropTargetDragEvent

dragExit

void dragExit(DropTargetEvent  dte)

드래그 조작중에 리스너에게 등록된 DropTarget 드롭 사이트의 조작 가능한 부분으로부터 마우스 포인터가 나왔을 때에 호출합니다.

파라미터:

dte - DropTargetEvent

drop

void drop(DropTargetDropEvent  dtde)

리스너에게 등록된 DropTarget 드롭 사이트의 조작 가능한 부분에의 드롭으로 드래그 조작이 종료했을 때에 호출합니다.

이 메서드는 제스추어에 관련한 데이터의 확실한 전송을 담당합니다. DropTargetDropEvent는 전송 대상의 데이터 객체를 나타내는 Transferable 객체를 얻는 수단을 제공합니다.

DropTargetDropEvent 파라미터의 acceptDrop(int dropAction) 메서드 또는 rejectDrop() 메서드를 사용해, DropTargetListener는 이 메서드로부터 드롭을 받아들이는지, 또는 거부합니다.

acceptDrop()보다 전은 아니고 후에 DropTargetDropEvent getTransferable() 메서드가 불려가 리턴된 Transferable getTransferData() 메서드를 사용해 데이터 변환을 합니다.

드롭의 완료시에는 이 메서드의 구현은, DropTargetDropEvent dropComplete(boolean success)에 해당의 boolean을 건네주는 것에의해 드롭의 성공 또는 실패를 통지할 필요가 있습니다.

주: 데이터 전송은 DropTargetDropEvent dropComplete(boolean success) 메서드에의 호출전에 완료하고 있을 필요가 있습니다. 그 후, 데이터 전송이 로컬의 경우에만, 즉, DropTargetDropEvent.isLocalTransfer()가 true를 돌려주는 경우에만, DropTargetDropEvent.getTransferable()가 돌려주는 Transferable getTransferData() 메서드의 호출이 확실히 성공합니다. 그렇지 않은 경우, 호출의 동작은 구현에 의존합니다.

파라미터:

dtde - DropTargetDropEvent