java.awt.dnd
인터페이스 DragSourceListener

모든 슈퍼 인터페이스:

EventListener

기존의 구현 클래스의 일람:

DragSourceAdapter , DragSourceContext

public interface DragSourceListener

extends EventListener

DragSourceListener 는 드러그＆드롭 조작에 관한 오리지네이타의 이벤트 인터페이스를 정의해, 유저의 제스추어 상태를 감시하거나 드러그＆드롭 조작 전체의 최적인 「드러그 오버」피드백을 유저에게 제공합니다.

도입된 버젼:

1.2

메소드의 개요

void	dragDropEnd (DragSourceDropEvent dsde) 이 메소드의 기동에 의해, 드러그＆드롭 조작이 완료한 것을 나타냅니다.
void	dragEnter (DragSourceDragEvent dsde) 커서의 핫 스포트가 플랫폼 의존의 드롭 사이트를 입력했을 때에 불려 갑니다.
void	dragExit (DragSourceEvent dse) 커서의 핫 스포트가 플랫폼 의존의 드롭 사이트를 종료했을 때에 불려 갑니다.
void	dragOver (DragSourceDragEvent dsde) 커서의 핫 스포트가 플랫폼 의존의 드롭 사이트로 이동했을 때에 불려 갑니다.
void	dropActionChanged (DragSourceDragEvent dsde) 유저가 드롭 제스추어를 변경했을 때에 불려 갑니다.

메소드의 상세

dragEnter

public void dragEnter(DragSourceDragEvent  dsde)

커서의 핫 스포트가 플랫폼 의존의 드롭 사이트를 입력했을 때에 불려 갑니다. 이 메소드는 다음의 조건이 모두 채워졌을 때에 불려 갑니다.

• 커서의 핫 스포트가 플랫폼 의존의 드롭 사이트의 조작 가능한 부분에 들어간다
• 드롭 사이트가 액티브하다
• 드롭 사이트가 드러그를 받아들인다

파라미터:

dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent  dsde)

커서의 핫 스포트가 플랫폼 의존의 드롭 사이트로 이동했을 때에 불려 갑니다. 이 메소드는 다음의 조건이 모두 채워졌을 때에 불려 갑니다.

• 커서의 핫 스포트는 이동했지만, 전의 dragEnter() 호출해에 관련한 드롭 사이트의 조작 가능한 부분과 아직 교차하고 있다
• 드롭 사이트가 아직 액티브하다
• 드롭 사이트가 드러그를 받아들인다

파라미터:

dsde - DragSourceDragEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent  dsde)

유저가 드롭 제스추어를 변경했을 때에 불려 갑니다. 이 메소드는 유저가 사용하고 있는 입력 디바이스 상태가 변경이 되었을 경우에 불려 갑니다. 이러한 디바이스는 통상, 유저가 사용하는 mouse button 또는 키보드 수식자가 됩니다.

파라미터:

dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent  dse)

커서의 핫 스포트가 플랫폼 의존의 드롭 사이트를 종료했을 때에 불려 갑니다. 이 메소드는 다음의 조건의 어떤 것인가가 채워졌을 때에 불려 갑니다.

• 커서의 핫 스포트가, 전의 dragEnter() 호출해에 관련한 드롭 사이트의 조작 가능한 부분과 교차하지 않게 되었다

또는

• 전의 dragEnter() 호출해에 관련한 드롭 사이트가 액티브하지 않게 되었다

또는

• 현재의 드롭 사이트에서 드러그가 거부되었다

파라미터:

dse - DragSourceEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent  dsde)

이 메소드의 기동에 의해, 드러그＆드롭 조작이 완료한 것을 나타냅니다. DragSourceDropEvent 의 getDropSuccess() 메소드를 사용해, 종료 상태를 결정할 수가 있습니다. getDropAction() 메소드는 Drop 조작에 적용하기 위해(때문에), 드롭 사이트가 선택한 조작을 돌려줍니다. 이 메소드가 완료하면(자), 현재의 DragSourceContext 및 관련하는 리소스는 무효가 됩니다.

파라미터:

dsde - DragSourceDropEvent