java.awt.dnd
클래스 DragSourceContext

java.lang.Object 
  |
  +--java.awt.dnd.DragSourceContext

모든 구현 인터페이스:

DragSourceListener , DragSourceMotionListener , EventListener , Serializable

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 로부터 불려 가 이 constructor 은 이 Drag 에 DragSourceContextPeer 를 제공하는 새로운 DragSourceContext 를 작성합니다.

메소드의 개요

void	addDragSourceListener (DragSourceListener dsl) 아직 1 kr이나 추가되어 있지 않은 경우, 이 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 의 DataFlavors 가 변경된 것을 피어에 통지합니다.
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 로부터 불려 가 이 constructor 은 이 Drag 에 DragSourceContextPeer 를 제공하는 새로운 DragSourceContext 를 작성합니다. 또, Drag 를 방아쇠 한 DragGestureEvent, Drag 에 사용하는 초기의 Cursor, Drag 의 실행중에 표시하는 (임의의) Image, 이벤트를 방아쇠 한 순간에서의 핫 스포트로부터의 Image 기점의 오프셋(offset),Transferable Subject 데이터, 및 드러그＆드롭 조작중에 사용하는 DragSourceListener 도 작성합니다.
DragSourceContextPeer 가 null 의 경우는 NullPointerException 가 슬로우 됩니다.
DragGestureEvent 이 null 의 경우는 NullPointerException 가 슬로우 됩니다.
Cursor 가 null 의 경우는 예외는 슬로우 되지 않고 디폴트의 드러그 커서가 이 드러그 조작에 사용됩니다.
Image 가 null 의 경우, 예외는 슬로우 되지 않습니다.
Image 가 null 는 아니고, 오프셋(offset)가 null 의 경우는 NullPointerException 가 슬로우 됩니다.
Transferable 이 null 의 경우는 NullPointerException 가 슬로우 됩니다.
DragSourceListener 가 null 의 경우, 예외는 슬로우 되지 않습니다.

파라미터:

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 를 설정합니다.

파라미터:

c - 표시하는 Cursor. null 는 금지되지 않지만, 이 파라미터의 허용치는 아니다

getCursor

public Cursor  getCursor()

이 메소드는 현재의 드러그 Cursor 를 돌려줍니다.

반환값:

현재의 드러그 Cursor

addDragSourceListener

public void addDragSourceListener(DragSourceListener  dsl)
                           throws TooManyListenersException 

아직 1 kr이나 추가되어 있지 않은 경우, 이 DragSourceContext 에 DragSourceListener 를 추가합니다. DragSourceListener 가 벌써 존재하는 경우, 이 메소드는 TooManyListenersException 를 슬로우 합니다.

파라미터:

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

예외:

TooManyListenersExceptionDragSourceListener - 가 벌써 추가되고 있는 경우

TooManyListenersException

removeDragSourceListener

public void removeDragSourceListener(DragSourceListener  dsl)

이 메소드는 지정한 DragSourceListener 를 이 DragSourceContext 로부터 삭제합니다.

파라미터:

dsl - 삭제 대상의 DragSourceListener. null 는 금지되지 않지만, 파라미터로서 허가되어 있지 않은 것에 주의

transferablesFlavorsChanged

public void transferablesFlavorsChanged()

이 메소드는 Transferable 의 DataFlavors 가 변경된 것을 피어에 통지합니다.

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 - 정수