java.awt.dnd
클래스 DragSourceContext

java.lang.Object 
  java.awt.dnd.DragSourceContext

모든 구현된 인터페이스:

DragSourceListener, DragSourceMotionListener, Serializable, EventListener

public class DragSourceContext
extends Object 
implements DragSourceListener,
 DragSourceMotionListener,
 Serializable 

DragSourceContext 클래스는 드래그＆드롭 프로토콜의 이니씨에이터측을 관리합니다. 특히, DragSourceListener와 DragSourceMotionListener에 의 드래그 이벤트 통지를 관리해, 드래그 조작의 소스 데이터를 나타내는 Transferable을 제공합니다.

DragSourceContext 자체는 DragSourceListener인터페이스와 DragSourceMotionListener인터페이스를 구현하고 있는 것에 주의해 주세요. 이것은, DragSource로 작성된 플랫폼 피어 (DragSourceContextPeer인스턴스)가DragSourceContext에 대해, 진행중의 조작 상태로 변경이 있던 것을 통지할 수 있도록 하기 때문에입니다. 이것에 의해 DragSourceContext는 플랫폼과 드래그 조작 이니씨에이터로 제공된 리스너의 사이에 DragSourceContext 자체를 삽입할 수 있습니다.

도입된 버전 :

1.2

관련 항목:

DragSourceListener, DragSourceMotionListener, 직렬화 된 형식

필드 개요

protected static int	CHANGED 사용자 조작이 변경된 것을 나타내는 updateCurrentCursor()로 사용되는 int 입니다.
protected static int	DEFAULT Cursor를 디폴트 (드롭 없음)의 Cursor로 변경하도록 지시하는 updateCurrentCursor()로 사용되는 int 입니다.
protected static int	ENTER Cursor가 DropTarget에 입력된 것을 나타내는 updateCurrentCursor()로 사용되는 int 입니다.
protected static int	OVER Cursor가 DropTarget 위에 있는 것을 나타내는 updateCurrentCursor()로 사용되는 int 입니다.

생성자 개요

DragSourceContext (java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point offset, Transferable t, DragSourceListener dsl)
DragSource로 부터 불려 간 이 생성자는 이 Drag DragSourceContextPeer, Drag를 트리거 한 DragGestureEvent, Drag에 사용하는 초기의 Cursor, Drag 실행중에 표시하는 (임의의) Image, 이벤트를 트리거 한 순간에서의 핫 스포트로부터의 Image 기점의 오프셋(offset), Transferable 주제 데이터 및 드래그＆드롭 조작중에 사용하는 DragSourceListener를 지정해, 새로운 DragSourceContext를 작성합니다.

메서드 개요

void	addDragSourceListener (DragSourceListener dsl) 아직 1개 또는 추가되어 있지 않은 경우, 이 DragSourceContext에 DragSourceListener를 추가합니다.
void	dragDropEnd (DragSourceDropEvent dsde) 이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dragDropEnd를 호출해, 지정된 DragSourceDropEvent에 건네줍니다.
void	dragEnter (DragSourceDragEvent dsde) 이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dragEnter를 호출해, 지정된 DragSourceDragEvent에 건네줍니다.
void	dragExit (DragSourceEvent dse) 이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dragExit를 호출해, 지정된 DragSourceEvent에 건네줍니다.
void	dragMouseMoved (DragSourceDragEvent dsde) 이 DragSourceContext에 관련된 DragSource에 등록된 DragSourceMotionListener로 dragMouseMoved을 호출해, 지정된 DragSourceDragEvent에 건네줍니다.
void	dragOver (DragSourceDragEvent dsde) 이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dragOver를 호출해, 지정된 DragSourceDragEvent에 건네줍니다.
void	dropActionChanged (DragSourceDragEvent dsde) 이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dropActionChanged를 호출해, 지정된 DragSourceDragEvent에 건네줍니다.
Component	getComponent () DragSourceContext에 관련한 Component를 리턴합니다.
Cursor	getCursor () 현재의 드래그 Cursor를 리턴합니다.
DragSource	getDragSource () 이 DragSourceContext 인스턴스를 생성한 DragSource를 리턴합니다.
int	getSourceActions () 이 DragSourceContext에 관련한 드래그 조작의 드래그 소스로 지원되고 있는 일련의 드롭 액션을 나타내는 DnDConstants 비트 단위의 마스크를 리턴합니다.
Transferable	getTransferable () DragSourceContext에 관련한 Transferable을 리턴합니다.
DragGestureEvent	getTrigger () 드래그를 최초로 트리거 한 DragGestureEvent를 리턴합니다.
void	removeDragSourceListener (DragSourceListener dsl) 지정된 DragSourceListener를 이 DragSourceContext로 부터 삭제합니다.
void	setCursor (Cursor c) 이 드래그 조작의 커서로 지정된 Cursor를 설정합니다.
void	transferablesFlavorsChanged () Transferable DataFlavor가 변경된 것을 피어에 통지합니다.
protected void	updateCurrentCursor (int dropOp, int targetAct, int status) 디폴트의 드래그 커서의 동작이 활성화된 경우, 이 메서드는 지정되어 선택된 조작, 지원되는 액션 및 스테이터스에 디폴트의 드래그 커서를 설정합니다.

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

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

필드의 상세

DEFAULT

protected static final int DEFAULT

Cursor를 디폴트 (드롭 없음)의 Cursor로 변경하도록 지시하는 updateCurrentCursor()로 사용되는 int 입니다.

관련 항목:

정수 필드값

ENTER

protected static final int ENTER

Cursor가 DropTarget에 입력된 것을 나타내는 updateCurrentCursor()로 사용되는 int 입니다.

관련 항목:

정수 필드값

OVER

protected static final int OVER

Cursor가 DropTarget 위에 있는 것을 나타내는 updateCurrentCursor()로 사용되는 int 입니다.

관련 항목:

정수 필드값

CHANGED

protected static final int CHANGED

사용자 조작이 변경된 것을 나타내는 updateCurrentCursor()로 사용되는 int 입니다.

관련 항목:

정수 필드값

생성자 상세

DragSourceContext

public DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp,
                         DragGestureEvent  trigger,
                         Cursor  dragCursor,
                         Image  dragImage,
                         Point  offset,
                         Transferable  t,
                         DragSourceListener  dsl)

DragSource로 부터 불려 간 이 생성자는 이 Drag DragSourceContextPeer, Drag를 트리거 한 DragGestureEvent, Drag에 사용하는 초기의 Cursor, Drag 실행중에 표시하는 (임의의) Image, 이벤트를 트리거 한 순간에서의 핫 스포트로부터의 Image 기점의 오프셋(offset), Transferable 주제 데이터 및 드래그＆드롭 조작중에 사용하는 DragSourceListener를 지정해, 새로운 DragSourceContext를 작성합니다.
DragSourceContextPeer가 null인 경우는 NullPointerException가 발생 됩니다.
DragGestureEvent 이 null인 경우는 NullPointerException가 발생 됩니다.
Cursor가 null인 경우, 예외가 발생되지 않고 디폴트의 드래그 커서의 동작이, 이 드래그 조작에 대해서 활성화 됩니다.
Image가 null인 경우, 예외는 Throw 되지 않습니다.
Image가 null이 아니고, 오프셋(offset)가 null인 경우는 NullPointerException가 발생 됩니다.
Transferable 이 null인 경우는 NullPointerException가 발생 됩니다.
DragSourceListener가 null인 경우, 예외는 Throw 되지 않습니다.

파라미터:

dscp - 이 드래그 의 DragSourceContextPeer

trigger - 트리거 이벤트

dragCursor - 초기의 Cursor

dragImage - 드래그 하는 Image (또는 null)

offset - 트리거 이벤트의 순간에서의, 핫 스포트로부터의 이미지 기점의 오프셋(offset)

t - Transferable

dsl - DragSourceListener

예외:

IllegalArgumentException - 트리거 이벤트에 관련된 Component이 null인 경우

IllegalArgumentException - 트리거 이벤트의 DragSource가 null인 경우

IllegalArgumentException - 트리거 이벤트의 드래그 액션이 DnDConstants.ACTION_NONE인 경우

IllegalArgumentException - 트리거 이벤트에 관련된 DragGestureRecognizer 소스 액션이 DnDConstants.ACTION_NONE와 동일한 경우

NullPointerException - dscp, trigger, 또는 t가 null인 경우. 또는 dragImage가 null은 아니고, 오프셋(offset)가 null인 경우

메서드의 상세

getDragSource

public DragSource  getDragSource()

이 DragSourceContext 인스턴스를 생성한 DragSource를 리턴합니다.

반환값:

이 DragSourceContext 인스턴스를 생성한 DragSource

getComponent

public Component  getComponent()

DragSourceContext에 관련한 Component를 리턴합니다.

반환값:

드래그를 개시시킨 Component

getTrigger

public DragGestureEvent  getTrigger()

드래그를 최초로 트리거 한 DragGestureEvent를 리턴합니다.

반환값:

드래그를 트리거 한 Event

getSourceActions

public int getSourceActions()

이 DragSourceContext에 관련한 드래그 조작의 드래그 소스로 지원되고 있는 일련의 드롭 액션을 나타내는 DnDConstants 비트 단위의 마스크를 리턴합니다.

반환값:

드래그 소스로 지원되고 있는 드롭 액션

setCursor

public void setCursor(Cursor  c)

이 드래그 조작의 커서로 지정된 Cursor를 설정합니다. 지정된 Cursor가 null인 경우는 디폴트의 드래그 커서의 동작이, 이 드래그 조작에 대해서 활성화 됩니다. null 이외의 경우는 디폴트의 드래그 커서의 동작이 비활성화 됩니다.

파라미터:

c - 표시하는 Cursor 또는 디폴트의 드래그 커서의 동작을 활성화 하는 경우는 null

getCursor

public Cursor  getCursor()

현재의 드래그 Cursor를 리턴합니다.

반환값:

현재의 드래그 Cursor

addDragSourceListener

public void addDragSourceListener(DragSourceListener  dsl)
                           throws TooManyListenersException 

아직 1개 또는 추가되어 있지 않은 경우, 이 DragSourceContext에 DragSourceListener를 추가합니다. DragSourceListener가 이미 존재하는 경우, 이 메서드는 TooManyListenersException을 Throw 합니다.

파라미터:

dsl - 추가 대상의 DragSourceListener. null은 금지되지 않지만, 파라미터로서 허가되어 있지 않다

예외:

TooManyListenersException - DragSourceListener가 이미 추가되고 있는 경우

TooManyListenersException

removeDragSourceListener

public void removeDragSourceListener(DragSourceListener  dsl)

지정된 DragSourceListener를 이 DragSourceContext로 부터 삭제합니다.

파라미터:

dsl - 삭제 대상의 DragSourceListener. null은 금지되지 않지만, 파라미터로서 받아들일 수 없다

transferablesFlavorsChanged

public void transferablesFlavorsChanged()

Transferable DataFlavor가 변경된 것을 피어에 통지합니다.

dragEnter

public void dragEnter(DragSourceDragEvent  dsde)

이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dragEnter를 호출해, 지정된 DragSourceDragEvent에 건네줍니다.

정의:

인터페이스 DragSourceListener 내의 dragEnter

파라미터:

dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent  dsde)

이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dragOver를 호출해, 지정된 DragSourceDragEvent에 건네줍니다.

정의:

인터페이스 DragSourceListener 내의 dragOver

파라미터:

dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent  dse)

이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dragExit를 호출해, 지정된 DragSourceEvent에 건네줍니다.

정의:

인터페이스 DragSourceListener 내의 dragExit

파라미터:

dse - DragSourceEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent  dsde)

이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dropActionChanged를 호출해, 지정된 DragSourceDragEvent에 건네줍니다.

정의:

인터페이스 DragSourceListener 내의 dropActionChanged

파라미터:

dsde - DragSourceDragEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent  dsde)

이 DragSourceContext 및 관련된 DragSource에 등록된 DragSourceListener로 dragDropEnd를 호출해, 지정된 DragSourceDropEvent에 건네줍니다.

정의:

인터페이스 DragSourceListener 내의 dragDropEnd

파라미터:

dsde - DragSourceDropEvent

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent  dsde)

이 DragSourceContext에 관련된 DragSource에 등록된 DragSourceMotionListener로 dragMouseMoved을 호출해, 지정된 DragSourceDragEvent에 건네줍니다.

정의:

인터페이스 DragSourceMotionListener 내의 dragMouseMoved

파라미터:

dsde - DragSourceDragEvent

도입된 버전 :

1.4

getTransferable

public Transferable  getTransferable()

DragSourceContext에 관련한 Transferable을 리턴합니다.

반환값:

Transferable

updateCurrentCursor

protected void updateCurrentCursor(int dropOp,
                                   int targetAct,
                                   int status)

디폴트의 드래그 커서의 동작이 활성화된 경우, 이 메서드는 지정되어 선택된 조작, 지원되는 액션 및 스테이터스에 디폴트의 드래그 커서를 설정합니다. 그렇지 않은 경우, 이 메서드는 아무것도 실시하지 않습니다.

파라미터:

dropOp - 사용자가 현재 선택한 조작

targetAct - 현재의 타겟의 지원가 끝난 액션

status - 정수