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) 사용자가 현재의 드롭 제스처(gesture)를 변경했을 경우에 불려 갑니다.

메소드의 상세

dragEnter

void dragEnter(DropTargetDragEvent  dtde)

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

파라미터:

dtde - DropTargetDragEvent

dragOver

void dragOver(DropTargetDragEvent  dtde)

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

파라미터:

dtde - DropTargetDragEvent

dropActionChanged

void dropActionChanged(DropTargetDragEvent  dtde)

사용자가 현재의 드롭 제스처(gesture)를 변경했을 경우에 불려 갑니다.

파라미터:

dtde - DropTargetDragEvent

dragExit

void dragExit(DropTargetEvent  dte)

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

파라미터:

dte - DropTargetEvent

drop

void drop(DropTargetDropEvent  dtde)

청취자에게 등록된 DropTarget 의 드롭 사이트의 조작 가능한 부분에의 드롭으로 드래그 조작이 종료했을 때에 불려 갑니다.

이 메소드는, 제스처(gesture)에 관련한 데이터의 확실한 전송을 담당합니다. 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