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 로 숨겨지지 않은 부분입니다.

도입된 버젼:

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

public void dragEnter(DropTargetDragEvent  dtde)

드러그 조작중에, 청취자에게 등록된 DropTarget 의 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 들어갔을 때에 불려 갑니다.

파라미터:

dtde - DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent  dtde)

드러그 조작중에, 청취자에게 등록된 DropTarget 의 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 아직 있을 때 불려 갑니다.

파라미터:

dtde - DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent  dtde)

유저가 현재의 드롭 제스추어를 변경했을 경우에 불려 갑니다.

파라미터:

dtde - DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent  dte)

드러그 조작중에, 청취자에게 등록된 DropTarget 의 드롭 사이트의 조작 가능한 부분으로부터 마우스 포인터가 나왔을 때에 불려 갑니다.

파라미터:

dte - DropTargetEvent

drop

public 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