패키지 java.awt.dnd

드래그＆드롭 조작은 많은 그래피컬 사용자 인터페이스 시스템으로 볼 수 있는 직접적인 조작 제스추어로 GUI 표현 요소에 논리적으로 관련한 2개의 엔티티간에 정보를 변환하는 도구를 제공합니다.

참조처:
설명

인터페이스 개요

Autoscroll	DnD 조작중, 그 시점에서는 사용자 로 보이지 않은 스크롤 가능한 GUI 컨트롤의 영역에 조작의 대상을 드롭 하고 싶은 경우가 있습니다.
DragGestureListener	이 인터페이스는 DragGestureRecognizer를 소스로 해, 그 (서브) 클래스의 객체가 드래그 개시 제스추어를 검출했을 때에 호출합니다.
DragSourceListener	DragSourceListener는 드래그＆드롭 조작에 관한 오리지네이타의 이벤트 인터페이스를 정의해, 사용자 의 제스추어 상태를 감시하거나 드래그＆드롭 조작 전체의 최적인 「드래그 오버」피드백을 사용자에 게 제공합니다.
DragSourceMotionListener	드래그 조작중의 마우스 모션 이벤트를 받기 위한 리스너 인터페이스입니다.
DropTargetListener	DropTargetListener인터페이스는 대상의 DropTarget을 포함한 DnD 조작의 통지를 DropTarget 클래스가 제공하는데 사용하는 콜백 인터페이스입니다.

클래스 개요

DnDConstants	이 클래스에는 드래그＆드롭 조작이 실행하는 액션의 형식을 나타내는 정수값이 있습니다.
DragGestureEvent	DragGestureEvent는 DragGestureListener dragGestureRecognized() 메서드에게 건네집니다.
DragGestureRecognizer	DragGestureRecognizer는 플랫폼 존의 드래그 개시 제스추어를 식별하기 위해서 특정의 Component에 관련된 플랫폼 존의 리스너를 지정하기 위한 추상 base class입니다.
DragSource	DragSource는 드래그＆드롭 조작의 개시를 담당하는 엔티티로 다음과 같은 몇개의 시나리오로 사용할 수 있습니다.
DragSourceAdapter	드래그 소스 이벤트를 받기 위한 추상 어댑터 클래스입니다.
DragSourceContext	DragSourceContext 클래스는 드래그＆드롭 프로토콜의 이니씨에이터측을 관리합니다.
DragSourceDragEvent	DragSourceDragEvent는 DragSourceContextPeer로 부터 DragSourceContext를 개입시켜, DragSourceContext 및 거기에 관련된 DragSource로 등록된 DragSourceListener에 보내집니다.
DragSourceDropEvent	DragSourceDropEvent는 DragSourceContextPeer로 부터 DragSourceContext를 개입시켜DragSourceContext 및 거기에 관련된 DragSource에 등록된 DragSourceListener dragDropEnd 메서드에 보내집니다.
DragSourceEvent	이 클래스는 DragSourceDragEvent 및 DragSourceDropEvent base class입니다.
DropTarget	DropTarget은 드래그＆드롭 조작동안에 Component이 드롭을 받아들이려고 할 경우에 Component에 관련지을 수 있습니다.
DropTarget.DropTargetAutoScroller	이 보호 대상의 상자가 되어 있는 클래스는 자동 스크롤을 구현합니다.
DropTargetAdapter	드롭 타겟 이벤트를 받기 위한 추상 어댑터 클래스입니다.
DropTargetContext	DropTargetContext는 드래그＆드롭 조작에 관련한 논리 커서가DropTarget에 관련한 Component 가시 지오메트리와 겹칠 때, 언제나 작성됩니다.
DropTargetDragEvent	DropTargetDragEvent는 그 dragEnter() 메서드 및 dragOver() 메서드를 개입시켜 DropTargetListener에 보내집니다.
DropTargetDropEvent	DropTargetDropEvent는 DropTargetListener drop() 메서드를 개입시켜 보내집니다.
DropTargetEvent	DropTargetEvent는 DropTargetDragEvent 및 DropTargetDropEvent base class입니다.
MouseDragGestureRecognizer	DragGestureRecognizer 이 추상 서브 클래스는 마우스 베이스의 제스추어의 DragGestureRecognizer를 정의합니다.

예외 개요

InvalidDnDOperationException

이 예외는 java.awt.dnd 패키지의 다양한 메서드에 의해 발생 됩니다.

패키지 java.awt.dnd 설명

드래그＆드롭 조작은 많은 그래피컬 사용자 인터페이스 시스템으로 볼 수 있는 직접적인 조작 제스추어로 GUI 표현 요소에 논리적으로 관련한 2개의 엔티티간에 정보를 변환하는 도구를 제공합니다. 드래그＆드롭은 보통, 적절한 입력 디바이스를 사용한 사용자 의 물리적 제스추어에 의해 동작해, 네비게이션중에 후속의 데이터 변환으로 생각되는 결과에 관한 사용자에 게로의 연속적인 피드백을 GUI 표현 요소를 개입시켜 가능하게 하는 도구와 후속의 데이터 네고시에이션과 데이터 변환을 용이하게 실시할 수 있는 기능의 양쪽 모두를 제공합니다.

이 패키지는 Java 로 드래그＆드롭 조작을 실시하는데 필요한 클래스 및 인터페이스를 정의합니다. 드래그 소스와 드롭 타겟의 클래스 및 드래그 되고 있는 데이터를 전송하기 위한 이벤트를 정의합니다. 이 패키지는 또, 드래그＆드롭 조작중에 사용자에 게 시각적인 피드백을 제공하는 수단을 갖추고 있습니다.

표준적인 드래그＆드롭 조작은 이하 상태 로 분해할 수 있습니다 (반드시 연속하지 않았다).

• GUI 표현 요소 (Component)에 관련한 DragSource 이 발생해, Transferable 라고 생각되는 데이터의 드래그＆드롭이 개시한다

• Transferable 데이터형을 사용할 수 있을 가능성이 있는 GUI 표현 요소 (Component)에 관련한 DropTarget이 1개 이상 나타나는지, 소실한다

• DragGestureRecognizer가 DragSource로 부터 취득되어 사용자 의 드래그 개시 제스추어를 Component 상에서 추적해 식별하기 위해서 Component와 관련지을 수 있다

• 사용자가 Component 상에서 드래그 제스추어를 실시하면, 등록된 DragGestureRecognizer가 그것을 검출해, 그 DragGestureListener를 통지한다

  주: 이 API는 일관해, 사용자에 한 물리적 제스추어인 드래그＆드롭 조작의 자극에 관련합니다만, 이것은, DragSource 구현이 적절한 경우에 프로그램상에서 행해지는 DnD 조작을 배제하는 것이 아닙니다. 이 패키지는 마우스 디바이스의 제스추어를 식별하는 추상 클래스 MouseDragGestureRecognizer를 포함하고 있습니다. 다른 입력 디바이스 또는 특정의 Component 클래스의 시멘틱스를 지원하기 위해서 플랫폼에 의해 다른 추상 클래스가 제공되는 일이 있습니다.

• DragGestureListener에 의해 DragSource가 사용자 대신에 드래그＆드롭 조작을 개시한다. 많은 경우, GUI Cursor를 동영상화하는지, 조작의 대상인 항목의 Image를 렌더링 하는지, 또는 그 양쪽 모두를 실시한다

• 사용자 의 제스추어가 DropTarget에 관련한 GUI Component 상을 안내하면, 지원되는 조작 및 관련된 데이터형에 거해, DragSource는 「드래그 오버」피드백 결과를 제공하기 위해서 통지를 받아, DropTarget은 「드래그 언더」피드백 결과를 제공하기 위해서 통지를 받는다

제스추어 자체는 GUI 계층을 또 있고로 논리 커서를 움직여, GUI Component 지오메트리와 겹칩니다. 그 결과론리적 「드래그 」커서가 Component 및 관련의 DropTarget에 들어가 횡단해, 그 후 떨어질 가능성이 있습니다.

DragSource객체는 사용자에 게 「드래그 오버」피드백을 나타냅니다. 보통 의 경우, 논리 커서에 관련한 GUI Cursor를 동영상화합니다.

DropTarget객체는 사용자에 게 「드래그 언더」피드백을 나타냅니다. 보통 의 경우, 관련된 GUI Component GUI Cursor에 애니메이션을 렌더링 합니다.

피드백 결과의 판정 및 반드시 어느 쪽인지가 발생하는 데이터 변환의 최종적인 성공 또는 실패는 다음과 같이 파라미터화 됩니다.

• 사용자가 선택해, DragSource와 DropTarget 양쪽 모두가 지원하는 변환 「조작」, 즉 Copy, Move 또는 Reference(link)에의해 파라미터화 된다

• DragSource가 제공하는 데이터형세트와DropTarget을 포괄할 수 있는 데이터형세트와의 공통 부분에의해 파라미터화 된다

• 일반적으로 드롭의 성공으로 끝나는 드래그 조작을 사용자가 종료할 때, DragSource 및 DropTarget은 DragSource에 관련한 정보를 포함해 그 정보의 형태의 네고시에이션 및 변환이 되는 통지를, Transferable 객체를 개입시키고 받는다

도입된 버전 :

1.2