java.awt.dnd
클래스 DragSource

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

모든 구현 인터페이스:

Serializable

public class DragSource

extends Object

implements Serializable

DragSource 는 드러그＆드롭 조작의 개시를 담당하는 엔티티로, 다음과 같은 몇개의 시나리오로 사용할 수 있습니다.

• JVM 마다, 그 JVM 의 수명의 사이 1 디폴트 인스턴스
• 잠재적인 드러그 이니씨에이터 오브젝트 (TextField 등)의 클래스 마다 1 인스턴스. 구현에 의해 다르다
• GUI 의 특정의 Component 의 인스턴스, 또는 Component 인스턴스에 관련지을 수 있고 있는 어플리케이션 고유의 오브젝트 마다 1 kr. 구현에 의해 다르다
• 그 외 임의가 관련짓고. 구현에 의해 다르다

DragSource 를 취득했을 경우는 DragGestureRecognizer 도 취득해,DragSource 를 특정의 Component 와 관련짓습니다.

유저의 제스추어의 최초의 구현, 및 그 후의 드러그 조작의 개시는 통상 DragGestureRecognizer 가 구현하는 구현 Component 가 담당합니다.

드러그 제스추어가 발생하면(자), 유저의 네비게이션 제스추어의 처리 및 드러그＆드롭 프로토콜 통지의 송달을 위해,DragSource 의 startDrag() 메소드가 불려 갑니다. DragSource 는 어느 시점에서도 현재의 드러그＆드롭 조작으로서 조작을 1 개만 허가해, 그 조작이 완료하는 시점까지 IllegalDnDOperationException 를 슬로우 하는 것에 의해 다른 startDrag() 요구를 거부합니다.

startDrag() 메소드는 createDragSourceContext() 메소드를 호출해 적절한 DragSourceContext 를 인스턴스화해,DragSourceContextPeer 를 거기에 관련짓습니다.

드러그＆드롭 시스템이 어떠한 이유로써 드러그 조작을 개시할 수 없는 경우, startDrag() 메소드는 java.awt.dnd.InvalidDnDOperationException 를 슬로우 해 그 상태를 통지합니다. 이 예외는 통상, 기초가 되는 플랫폼 시스템이 드러그를 개시하는 상태에 없는지 혹은 지정된 파라미터가 무효인 경우에 슬로우 됩니다.

드러그중은 드러그 조작의 개시시점에 전송 바탕으로야는 밝혀진 일련의 조작은 그 조작이 완료할 때까지 변경할 수 없습니다. DragSource 에 관해서, 조작중은 그 조작은 일정하고 있습니다.

도입된 버젼:

1.2

관련 항목:

직렬화 된 형식

필드의 개요

static Cursor	DefaultCopyDrop 카피 조작과 함께 사용해, 드롭이 현재 허가되고 있는 것을 나타내는 디폴트의 Cursor 입니다.
static Cursor	DefaultCopyNoDrop 카피 조작과 함께 사용해, 드롭이 현재 허가되어 있지 않은 것을 나타내는 디폴트의 Cursor 입니다.
static Cursor	DefaultLinkDrop 링크 조작과 함께 사용해, 드롭이 현재 허가되고 있는 것을 나타내는 디폴트의 Cursor 입니다.
static Cursor	DefaultLinkNoDrop 링크 조작과 함께 사용해, 드롭이 현재 허가되어 있지 않은 것을 나타내는 디폴트의 Cursor 입니다.
static Cursor	DefaultMoveDrop 이동 조작과 함께 사용해, 드롭이 현재 허가되고 있는 것을 나타내는 디폴트의 Cursor 입니다.
static Cursor	DefaultMoveNoDrop 이동 조작과 함께 사용해, 드롭이 현재 허가되어 있지 않은 것을 나타내는 디폴트의 Cursor 입니다.

생성자의 개요

DragSource ()
새로운 DragSource 를 구축합니다.

메소드의 개요

void	addDragSourceListener (DragSourceListener dsl) 지정된 DragSourceListener 를 이 DragSource 에 추가해, 이 DragSource 로 개시된 드러그 조작중의 드러그 소스 이벤트를 수신합니다.
void	addDragSourceMotionListener (DragSourceMotionListener dsml) 지정된 DragSourceMotionListener 를 이 DragSource 에 추가해, 이 DragSource 로 개시된 드러그 조작중의 드러그 모션 이벤트를 수신합니다.
DragGestureRecognizer	createDefaultDragGestureRecognizer (Component c, int actions, DragGestureListener dgl) DragGestureRecognizer 의 디폴트 추상 서브 클래스를 구현하는 새로운 DragSourceRecognizer 를 이 DragSource 에 작성해, 새롭게 작성된 오브젝트에, 지정된 Component 및 DragGestureListener 를 설정합니다.
DragGestureRecognizer	createDragGestureRecognizer (Class recognizerAbstractClass, Component c, int actions, DragGestureListener dgl) DragGestureRecognizer 의 지정된 추상 서브 클래스를 구현하는 새로운 DragGestureRecognizer 를 작성해, 새롭게 작성된 오브젝트에, 지정된 Component 및 DragGestureListener 를 설정합니다.
protected DragSourceContext	createDragSourceContext (java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent dgl, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable t, DragSourceListener dsl) 이 드러그를 처리하는 DragSourceContext 를 작성합니다.
static DragSource	getDefaultDragSource () 이 메소드는 기초가 되는 플랫폼에 관련한 DragSource 오브젝트를 돌려줍니다.
DragSourceListener []	getDragSourceListeners () 이 DragSource 로 등록한 모든 DragSourceListener 의 배열을 돌려줍니다.
DragSourceMotionListener []	getDragSourceMotionListeners () 이 DragSource 로 등록한 모든 DragSourceMotionListener 의 배열을 돌려줍니다.
FlavorMap	getFlavorMap () 이 메소드는 이 DragSource 의 FlavorMap 를 돌려줍니다.
EventListener []	getListeners (Class listenerType) 이 DragSource 의 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다.
static boolean	isDragImageSupported () 이 메소드는 기본이 되는 플랫폼에서 드러그 Image 의 서포트가 가능한가 어떤가를 나타내는 boolean 를 돌려줍니다.
void	removeDragSourceListener (DragSourceListener dsl) 지정된 DragSourceListener 를 이 DragSource 로부터 삭제합니다.
void	removeDragSourceMotionListener (DragSourceMotionListener dsml) 지정된 DragSourceMotionListener 를 이 DragSource 로부터 삭제합니다.
void	startDrag (DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point dragOffset, Transferable transferable, DragSourceListener dsl) 드러그를 개시한 DragGestureEvent, 사용하는 초기 Cursor, 드러그 하는 Image, 방아쇠의 순간에 있어서의 Cursor 의 핫 스포트로부터의 Image 원점의 오프셋(offset), 드러그의 대상 데이터, 및 DragSourceListener 를 받아, 드러그를 개시합니다.
void	startDrag (DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl, FlavorMap flavorMap) 드러그를 개시한 DragGestureEvent, 사용하는 초기 Cursor, 드러그 하는 Image, 방아쇠의 순간에 있어서의 Cursor 의 핫 스포트로부터의 Image 원점의 오프셋(offset), 드러그의 Transferable 대상 데이터,DragSourceListener, 및 FlavorMap 를 받아, 드러그를 개시합니다.
void	startDrag (DragGestureEvent trigger, Cursor dragCursor, Transferable transferable, DragSourceListener dsl) 드러그를 개시한 DragGestureEvent, 사용하는 초기 Cursor 드러그의 Transferable 대상 데이터, 및 DragSourceListener 를 받아, 드러그를 개시합니다.
void	startDrag (DragGestureEvent trigger, Cursor dragCursor, Transferable transferable, DragSourceListener dsl, FlavorMap flavorMap) 드러그를 개시한 DragGestureEvent, 사용하는 초기 Cursor, 드러그의 Transferable 대상 데이터,DragSourceListener, 및 FlavorMap 를 받아, 드러그를 개시합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

DefaultCopyDrop

public static final Cursor  DefaultCopyDrop

카피 조작과 함께 사용해, 드롭이 현재 허가되고 있는 것을 나타내는 디폴트의 Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는 null 입니다.

관련 항목:

GraphicsEnvironment.isHeadless()

DefaultMoveDrop

public static final Cursor  DefaultMoveDrop

이동 조작과 함께 사용해, 드롭이 현재 허가되고 있는 것을 나타내는 디폴트의 Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는 null 입니다.

관련 항목:

GraphicsEnvironment.isHeadless()

DefaultLinkDrop

public static final Cursor  DefaultLinkDrop

링크 조작과 함께 사용해, 드롭이 현재 허가되고 있는 것을 나타내는 디폴트의 Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는 null 입니다.

관련 항목:

GraphicsEnvironment.isHeadless()

DefaultCopyNoDrop

public static final Cursor  DefaultCopyNoDrop

카피 조작과 함께 사용해, 드롭이 현재 허가되어 있지 않은 것을 나타내는 디폴트의 Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는 null 입니다.

관련 항목:

GraphicsEnvironment.isHeadless()

DefaultMoveNoDrop

public static final Cursor  DefaultMoveNoDrop

이동 조작과 함께 사용해, 드롭이 현재 허가되어 있지 않은 것을 나타내는 디폴트의 Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는 null 입니다.

관련 항목:

GraphicsEnvironment.isHeadless()

DefaultLinkNoDrop

public static final Cursor  DefaultLinkNoDrop

링크 조작과 함께 사용해, 드롭이 현재 허가되어 있지 않은 것을 나타내는 디폴트의 Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는 null 입니다.

관련 항목:

GraphicsEnvironment.isHeadless()

생성자의 상세

DragSource

public DragSource()
           throws HeadlessException 

새로운 DragSource 를 구축합니다.

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

getDefaultDragSource

public static DragSource  getDefaultDragSource()

이 메소드는 기초가 되는 플랫폼에 관련한 DragSource 오브젝트를 돌려줍니다.

반환값:

플랫폼 DragSource

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

isDragImageSupported

public static boolean isDragImageSupported()

이 메소드는 기본이 되는 플랫폼에서 드러그 Image 의 서포트가 가능한가 어떤가를 나타내는 boolean 를 돌려줍니다.

반환값:

이 플랫폼에서 드러그 이미지 서포트가 가능한 경우

startDrag

public void startDrag(DragGestureEvent  trigger,
                      Cursor  dragCursor,
                      Image  dragImage,
                      Point  imageOffset,
                      Transferable  transferable,
                      DragSourceListener  dsl,
                      FlavorMap  flavorMap)
               throws InvalidDnDOperationException 

드러그를 개시한 DragGestureEvent, 사용하는 초기 Cursor, 드러그 하는 Image, 방아쇠의 순간에 있어서의 Cursor 의 핫 스포트로부터의 Image 원점의 오프셋(offset), 드러그의 Transferable 대상 데이터,DragSourceListener, 및 FlavorMap 를 받아, 드러그를 개시합니다.

파라미터:

trigger - 드러그를 개시시킨 DragGestureEvent

dragCursor - 초기 Cursor, 또는 디폴트의 경우 null

dragImage - 드러그 하는 이미지 또는 null

imageOffset - 방아쇠의 순간에 있어서의,Cursor 의 핫 스포트로부터의 Image 원점의 오프셋(offset)

transferable - 드러그의 대상 데이터

dsl - DragSourceListener

flavorMap - 사용하는 FlavorMap, 또는 null

예외:

java.awt.dnd.InvalidDnDOperationException - 드러그＆드롭 시스템이 드러그 조작을 개시할 수 없는 경우, 또는 기존의 드러그 조작을 실행중에 유저가 드러그를 개시하려고 했을 경우

InvalidDnDOperationException

startDrag

public void startDrag(DragGestureEvent  trigger,
                      Cursor  dragCursor,
                      Transferable  transferable,
                      DragSourceListener  dsl,
                      FlavorMap  flavorMap)
               throws InvalidDnDOperationException 

드러그를 개시한 DragGestureEvent, 사용하는 초기 Cursor, 드러그의 Transferable 대상 데이터,DragSourceListener, 및 FlavorMap 를 받아, 드러그를 개시합니다.

파라미터:

trigger - 드러그를 개시시킨 DragGestureEvent

dragCursor - 초기 Cursor, 또는 디폴트의 경우 null

transferable - 드러그의 대상 데이터

dsl - DragSourceListener

flavorMap - 사용하는 FlavorMap, 또는 null

예외:

java.awt.dnd.InvalidDnDOperationException - 드러그＆드롭 시스템이 드러그 조작을 개시할 수 없는 경우, 또는 기존의 드러그 조작을 실행중에 유저가 드러그를 개시하려고 했을 경우

InvalidDnDOperationException

startDrag

public void startDrag(DragGestureEvent  trigger,
                      Cursor  dragCursor,
                      Image  dragImage,
                      Point  dragOffset,
                      Transferable  transferable,
                      DragSourceListener  dsl)
               throws InvalidDnDOperationException 

드러그를 개시한 DragGestureEvent, 사용하는 초기 Cursor, 드러그 하는 Image, 방아쇠의 순간에 있어서의 Cursor 의 핫 스포트로부터의 Image 원점의 오프셋(offset), 드러그의 대상 데이터, 및 DragSourceListener 를 받아, 드러그를 개시합니다.

파라미터:

trigger - 드러그를 개시시킨 DragGestureEvent

dragCursor - 초기 Cursor, 또는 디폴트의 경우 null

dragImage - 드러그 하는 Image 또는 null

transferable - 드러그의 대상 데이터

dsl - DragSourceListener

예외:

java.awt.dnd.InvalidDnDOperationException - 드러그＆드롭 시스템이 드러그 조작을 개시할 수 없는 경우, 또는 기존의 드러그 조작을 실행중에 유저가 드러그를 개시하려고 했을 경우

InvalidDnDOperationException

startDrag

public void startDrag(DragGestureEvent  trigger,
                      Cursor  dragCursor,
                      Transferable  transferable,
                      DragSourceListener  dsl)
               throws InvalidDnDOperationException 

드러그를 개시한 DragGestureEvent, 사용하는 초기 Cursor 드러그의 Transferable 대상 데이터, 및 DragSourceListener 를 받아, 드러그를 개시합니다.

파라미터:

trigger - 드러그를 개시시킨 DragGestureEvent

dragCursor - 초기 Cursor, 또는 디폴트의 경우 null

transferable - 드러그의 대상 데이터

dsl - DragSourceListener

예외:

java.awt.dnd.InvalidDnDOperationException - 드러그＆드롭 시스템이 드러그 조작을 개시할 수 없는 경우, 또는 기존의 드러그 조작을 실행중에 유저가 드러그를 개시하려고 했을 경우

InvalidDnDOperationException

createDragSourceContext

protected DragSourceContext  createDragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp,
                                                    DragGestureEvent  dgl,
                                                    Cursor  dragCursor,
                                                    Image  dragImage,
                                                    Point  imageOffset,
                                                    Transferable  t,
                                                    DragSourceListener  dsl)

이 드러그를 처리하는 DragSourceContext 를 작성합니다. 새로운 DragSourceContext 서브 클래스를 짜넣으려면 ,DragSource 를 서브 클래스화해, 이 메소드를 오버라이드(override) 합니다.

파라미터:

dscp - 이 드러그의 DragSourceContextPeer

dragCursor - 표시하는 초기 Cursor

dragImage - 드러그 하는 Image 또는 null

imageOffset - 방아쇠의 순간에 있어서의, 커서의 핫 스포트로부터의 Image 원점의 오프셋(offset)

dsl - DragSourceListener

반환값:

DragSourceContext

getFlavorMap

public FlavorMap  getFlavorMap()

이 메소드는 이 DragSource 의 FlavorMap 를 돌려줍니다.

반환값:

이 DragSource 의 FlavorMap

createDragGestureRecognizer

public DragGestureRecognizer  createDragGestureRecognizer(Class  recognizerAbstractClass,
                                                         Component  c,
                                                         int actions,
                                                         DragGestureListener  dgl)

DragGestureRecognizer 의 지정된 추상 서브 클래스를 구현하는 새로운 DragGestureRecognizer 를 작성해, 새롭게 작성된 오브젝트에, 지정된 Component 및 DragGestureListener 를 설정합니다.

파라미터:

recognizerAbstractClass - 요구된 추상형

actions - 허가된 소스 드러그 액션

c - Component 타겟

dgl - 통지하는 DragGestureListener

반환값:

새로운 DragGestureRecognizer. 또는 Toolkit.createDragGestureRecognizer() 메소드가 요구된 DragGestureRecognizer 서브 클래스에 사용 가능한 구현을 가지지 않고 null 를 돌려주었을 경우,null

createDefaultDragGestureRecognizer

public DragGestureRecognizer  createDefaultDragGestureRecognizer(Component  c,
                                                                int actions,
                                                                DragGestureListener  dgl)

DragGestureRecognizer 의 디폴트 추상 서브 클래스를 구현하는 새로운 DragSourceRecognizer 를 이 DragSource 에 작성해, 새롭게 작성된 오브젝트에, 지정된 Component 및 DragGestureListener 를 설정합니다. 이 DragSource 의 경우, 디폴트는 MouseDragGestureRecognizer 입니다.

파라미터:

c - recognizer의 Component 타겟

actions - 허가된 소스 액션

dgl - 통지하는 DragGestureListener

반환값:

새로운 DragGestureRecognizer. 또는 Toolkit.createDragGestureRecognizer() 메소드가 요구된 DragGestureRecognizer 서브 클래스에 사용 가능한 구현을 가지지 않고 null 를 돌려주었을 경우,null

addDragSourceListener

public void addDragSourceListener(DragSourceListener  dsl)

지정된 DragSourceListener 를 이 DragSource 에 추가해, 이 DragSource 로 개시된 드러그 조작중의 드러그 소스 이벤트를 수신합니다. null 의 청취자가 지정되었을 경우는 아무것도 처리는 행해지지 않고 예외는 슬로우 되지 않습니다.

파라미터:

dsl - 추가하는 DragSourceListener

도입된 버젼:

1.4

관련 항목:

removeDragSourceListener(java.awt.dnd.DragSourceListener) , getDragSourceListeners()

removeDragSourceListener

public void removeDragSourceListener(DragSourceListener  dsl)

지정된 DragSourceListener 를 이 DragSource 로부터 삭제합니다. null 의 청취자가 지정되었을 경우는 아무것도 처리는 행해지지 않고 예외는 슬로우 되지 않습니다. 인수로 지정된 청취자가 전에 이 DragSource 에 추가되어 있지 않은 경우는 아무것도 처리는 행해지지 않고 예외는 슬로우 되지 않습니다.

파라미터:

dsl - 삭제하는 DragSourceListener

도입된 버젼:

1.4

관련 항목:

addDragSourceListener(java.awt.dnd.DragSourceListener) , getDragSourceListeners()

getDragSourceListeners

public DragSourceListener [] getDragSourceListeners()

이 DragSource 로 등록한 모든 DragSourceListener 의 배열을 돌려줍니다.

반환값:

이 DragSource 의 모든 DragSourceListener. 해당하는 청취자가 현재 등록되지 않은 경우는 하늘의 배열

도입된 버젼:

1.4

관련 항목:

addDragSourceListener(java.awt.dnd.DragSourceListener) , removeDragSourceListener(java.awt.dnd.DragSourceListener)

addDragSourceMotionListener

public void addDragSourceMotionListener(DragSourceMotionListener  dsml)

지정된 DragSourceMotionListener 를 이 DragSource 에 추가해, 이 DragSource 로 개시된 드러그 조작중의 드러그 모션 이벤트를 수신합니다. null 의 청취자가 지정되었을 경우는 아무것도 처리는 행해지지 않고 예외는 슬로우 되지 않습니다.

도입된 버젼:

1.4

관련 항목:

removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener) , getDragSourceMotionListeners()

removeDragSourceMotionListener

public void removeDragSourceMotionListener(DragSourceMotionListener  dsml)

지정된 DragSourceMotionListener 를 이 DragSource 로부터 삭제합니다. null 의 청취자가 지정되었을 경우는 아무것도 처리는 행해지지 않고 예외는 슬로우 되지 않습니다. 인수로 지정된 청취자가 전에 이 DragSource 에 추가되어 있지 않은 경우는 아무것도 처리는 행해지지 않고 예외는 슬로우 되지 않습니다.

파라미터:

dsml - 삭제하는 DragSourceMotionListener

도입된 버젼:

1.4

관련 항목:

addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener) , getDragSourceMotionListeners()

getDragSourceMotionListeners

public DragSourceMotionListener [] getDragSourceMotionListeners()

이 DragSource 로 등록한 모든 DragSourceMotionListener 의 배열을 돌려줍니다.

반환값:

이 DragSource 의 모든 DragSourceMotionListener. 해당하는 청취자가 현재 등록되지 않은 경우는 하늘의 배열

도입된 버젼:

1.4

관련 항목:

addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener) , removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)

getListeners

public EventListener [] getListeners(Class  listenerType)

이 DragSource 의 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다. FooListener 는 addFooListener 메소드를 사용해 등록합니다.

파라미터:

listenerType - 요구되는 청취자의 타입. 이 파라미터는 java.util.EventListener 로부터 파생하는 인터페이스를 지정한다

반환값:

이 DragSource 에 FooListener 로서 등록된 모든 오브젝트의 배열. 해당하는 청취자가 추가되어 있지 않은 경우는 하늘의 배열

예외:

ClassCastExceptionlistenerType - 가 java.util.EventListener 를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우

도입된 버젼:

1.4

관련 항목:

getDragSourceListeners() , getDragSourceMotionListeners()