java.awt.dnd
클래스 DragSourceAdapter

java.lang.Object 
  java.awt.dnd.DragSourceAdapter

모든 구현된 인터페이스:

DragSourceListener, DragSourceMotionListener, EventListener

public abstract class DragSourceAdapter
extends Object 
implements DragSourceListener,
 DragSourceMotionListener 

드래그 소스 이벤트를 받기 위한 추상 어댑터 클래스입니다. 이 클래스의 메서드는 모두 비어있습니다. 이 클래스는 리스너 객체의 작성을 용이하게 하기 위한(해)인 만큼 제공되고 있습니다.

DragSourceEvent 리스너를 작성하려면, 이 클래스를 확장해 관련 이벤트에 대한 메서드를 오버라이드(override) 합니다. DragSourceListener인터페이스를 구현하는 경우는 그 중의 메서드를 모두 정의해야 합니다. 이 추상 클래스는 구현이 필요한 모든 메서드에 대해 비어있는 정의를 하고 있으므로 필요한 이벤트용의 메서드를 정의하는 것만으로 끝납니다.

확장한 클래스를 사용해 리스너 객체를 작성 후, 리스너 객체를 DragSource에 등록합니다. 드래그에 의해 드롭 사이트가 입력, 이동, 또는 종료되거나 드롭 액션이 변경되거나 혹은 드래그가 종료하거나 하면, 리스너 객체의 관련된 메서드가 불려가 그 메서드에 DragSourceEvent이 건네받습니다.

이 어댑터의 dragEnter() 마지막 호출이 드롭 사이트에 대응해, 이 어댑터의 dragExit() 호출이 나중에 계속되지 않는 경우는 드롭 사이트는 전의 dragEnter() 호출에 관련지을 수 있습니다.

도입된 버전 :

1.4

관련 항목:

DragSourceEvent, DragSourceListener, DragSourceMotionListener

생성자 개요

DragSourceAdapter ()

메서드 개요

void	dragDropEnd (DragSourceDropEvent dsde) 이 메서드의 시작에의해 드래그＆드롭 조작이 완료한 것을 나타냅니다.
void	dragEnter (DragSourceDragEvent dsde) 플랫폼 존의 드롭 사이트에 들어가는 커서의 핫 스포트로서 호출합니다.
void	dragExit (DragSourceEvent dse) 플랫폼 존의 드롭 사이트에서 나오는 커서의 핫 스포트로서 호출합니다.
void	dragMouseMoved (DragSourceDragEvent dsde) 드래그 조작중에 마우스가 이동했을 때에 호출합니다.
void	dragOver (DragSourceDragEvent dsde) 플랫폼 존의 드롭 사이트로 이동하는 커서의 핫 스포트로서 호출합니다.
void	dropActionChanged (DragSourceDragEvent dsde) 사용자가 드롭 제스추어를 수정했을 때에 불려 갔습니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

DragSourceAdapter

public DragSourceAdapter()

메서드의 상세

dragEnter

public void dragEnter(DragSourceDragEvent  dsde)

플랫폼 존의 드롭 사이트에 들어가는 커서의 핫 스포트로서 호출합니다. 이 메서드는 다음의 모든 조건이 들어맞는 경우에 호출합니다.

• 커서의 핫 스포트가 플랫폼 존의 드롭 사이트의 조작 가능한 부분에 들어간다
• 드롭 사이트가 활성화되었다
• 드롭 사이트가 드래그를 받아들인다

정의:

인터페이스 DragSourceListener 내의 dragEnter

파라미터:

dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent  dsde)

플랫폼 존의 드롭 사이트로 이동하는 커서의 핫 스포트로서 호출합니다. 이 메서드는 다음의 모든 조건이 들어맞는 경우에 호출합니다.

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

정의:

인터페이스 DragSourceListener 내의 dragOver

파라미터:

dsde - DragSourceDragEvent

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent  dsde)

드래그 조작중에 마우스가 이동했을 때에 호출합니다.

정의:

인터페이스 DragSourceMotionListener 내의 dragMouseMoved

파라미터:

dsde - DragSourceDragEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent  dsde)

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

정의:

인터페이스 DragSourceListener 내의 dropActionChanged

파라미터:

dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent  dse)

플랫폼 존의 드롭 사이트에서 나오는 커서의 핫 스포트로서 호출합니다. 이 메서드는 다음의 모든 조건이 들어맞는 경우에 호출합니다.

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

또는

• 전의 dragEnter() 호출해에 관련한 드롭 사이트가 활성화되지 않게 되었다

또는

• 전의 dragEnter() 호출해에 관련한 드롭 사이트에서 드래그가 거부되었다

정의:

인터페이스 DragSourceListener 내의 dragExit

파라미터:

dse - DragSourceEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent  dsde)

이 메서드의 시작에의해 드래그＆드롭 조작이 완료한 것을 나타냅니다. DragSourceDropEvent getDropSuccess() 메서드를 사용해, 종료 상태를 결정할 수 있습니다 . getDropAction() 메서드는 Drop 조작에 적용하기 위해, 드롭 사이트가 선택한 조작을 리턴합니다. 이 메서드가 완료하면, 현재의 DragSourceContext 및 관련된 자원은 무효가 됩니다.

정의:

인터페이스 DragSourceListener 내의 dragDropEnd

파라미터:

dsde - DragSourceDropEvent