DragSource (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드

## 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 개(살). 구현에 의해 다르다
- 그 외 임의가 관련짓고. 구현에 의해 다르다

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

사용자의 제스처(gesture)의 최초의 구현, 및 그 후의 드래그 조작의 개시는, 일반적으로 `DragGestureRecognizer` 가 구현하는 구현 `Component` 가 담당합니다.

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

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

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

드래그중은, 드래그 조작의 개시시점에 전송 바탕으로야는 밝혀진 일련의 조작은, 그 조작이 완료할 때까지 변경할 수 없습니다. `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)` 이 `DragSource` 에 `DragGestureRecognizer` 의 디폴트 추상 서브 클래스를 구현하는 새로운 `DragSourceRecognizer` 를 작성해, 새롭게 작성된 객체에, 지정된 `Component` 및 `DragGestureListener` 를 설정합니다.

`

`<T extends DragGestureRecognizer > T`

`

`createDragGestureRecognizer (Class <T> 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` 를 가져옵니다.
`static int` | `getDragThreshold ()` 드래그 제스처(gesture) 모션의 임계치를 돌려줍니다.
`FlavorMap` | `getFlavorMap ()` 이 메소드는, 이 `DragSource` 의 `FlavorMap` 를 돌려줍니다.

`

`<T extends EventListener > T[]`

`

`getListeners (Class <T> listenerType)`
이 `DragSource` 에 `FooListener` 로서 현재 등록되어 모든 객체를 가져옵니다.

`static boolean` | `isDragImageSupported ()` 기본이 되는 플랫폼에서 드래그 `Image` 의 지원가 가능한가 어떤가를 보고합니다.
`void` | `removeDragSourceListener (DragSourceListener dsl)` 이 `DragSource` 로부터 지정된 `DragSourceListener` 를 삭제합니다.
`void` | `removeDragSourceMotionListener (DragSourceMotionListener dsml)` 이 `DragSource` 로부터 지정된 `DragSourceMotionListener` 를 삭제합니다.
`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` 의 지원가 가능한가 어떤가를 보고합니다.

  반환값:
    이 플랫폼에서 드래그 이미지 지원가 가능한 경우

### 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`
    `dragOffset` - 트리거의 순간에 있어서의,`Cursor` 의 핫 스포트로부터의 `Image` 원점의 오프셋(offset)
    `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) 합니다.

  `dragImage` 가 `null` 의 경우는, 이 드래그 조작의 드래그 오버 피드백을 나타내기 위해서(때문에) 이미지가 사용됩니다만,`NullPointerException` 는 throw 되지 않습니다.

  `dsl` 가 `null` 의 경우는, 작성된 `DragSourceContext` 에 드래그 소스 리스너가 등록되지 않습니다만,`NullPointerException` 는 throw 되지 않습니다.

  `dragCursor` 가 `null` 의 경우는, 디폴트의 드래그 커서가 이 드래그 조작에 사용됩니다. `NullPointerException` 는 throw 되지 않습니다.

  파라미터:
    `dscp` - 이 드래그의 `DragSourceContextPeer`
    `dgl` - 드래그를 트리거했다 `DragGestureEvent`
    `dragCursor` - 표시하는 초기 `Cursor`
    `dragImage` - 드래그 하는 `Image` 또는 `null`
    `imageOffset` - 트리거의 순간에 있어서의, 커서의 핫 스포트로부터의 `Image` 원점의 오프셋(offset)
    `t` - 드래그의 대상 데이터
    `dsl` - `DragSourceListener`
  반환값:
    `DragSourceContext`
  예외:
    `NullPointerException` - `dscp` 가 `null` 의 경우
    `NullPointerException` - `dgl` 가 `null` 의 경우
    `NullPointerException` - `dragImage` 가 `null` 가 아니고,`imageOffset` 가 `null` 의 경우
    `NullPointerException` - `t` 가 `null` 의 경우
    `IllegalArgumentException` - 트리거 이벤트에 관련지을 수 있었던 `Component` 가 `null` 의 경우
    `IllegalArgumentException` - 트리거 이벤트의 `DragSource` 가 `null` 의 경우
    `IllegalArgumentException` - 트리거 이벤트의 드래그 액션이 `DnDConstants.ACTION_NONE` 의 경우
    `IllegalArgumentException` - 트리거 이벤트에 관련지을 수 있었다 `DragGestureRecognizer` 의 소스 액션이 `DnDConstants.ACTION_NONE` 와 동일한 경우

### getFlavorMap

    public FlavorMap  getFlavorMap()

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

  반환값:
    이 `DragSource` 의 `FlavorMap`

### createDragGestureRecognizer

    public <T extends DragGestureRecognizer > T createDragGestureRecognizer(Class <T> 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)

  이 `DragSource` 에 `DragGestureRecognizer` 의 디폴트 추상 서브 클래스를 구현하는 새로운 `DragSourceRecognizer` 를 작성해, 새롭게 작성된 객체에, 지정된 `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` 의 청취자가 지정되었을 경우는, 아무것도 처리는 행해지지 않고, 예외는 throw 되지 않습니다.

  `
  파라미터:
    `dsl` - 추가하는 `DragSourceListener`
  도입된 버젼:
    1.4
  관련 항목:
    `removeDragSourceListener(java.awt.dnd.DragSourceListener)` , `getDragSourceListeners()`

### removeDragSourceListener

    public void removeDragSourceListener(DragSourceListener  dsl)

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

  `
  파라미터:
    `dsl` - 삭제하는 `DragSourceListener`
  도입된 버젼:
    1.4
  관련 항목:
    `addDragSourceListener(java.awt.dnd.DragSourceListener)` , `getDragSourceListeners()`

### getDragSourceListeners

    public DragSourceListener [] getDragSourceListeners()

  이 `DragSource` 에 등록된 모든 `DragSourceListener` 를 가져옵니다.

  반환값:
    이 `DragSource` 의 모든 `DragSourceListener`. 해당하는 청취자가 현재 등록되지 않은 경우는, 빈 상태(empty)의 배열
  도입된 버젼:
    1.4
  관련 항목:
    `addDragSourceListener(java.awt.dnd.DragSourceListener)` , `removeDragSourceListener(java.awt.dnd.DragSourceListener)`

### addDragSourceMotionListener

    public void addDragSourceMotionListener(DragSourceMotionListener  dsml)

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

  `
  파라미터:
    `dsml` - 추가하는 `DragSourceMotionListener`
  도입된 버젼:
    1.4
  관련 항목:
    `removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)` , `getDragSourceMotionListeners()`

### removeDragSourceMotionListener

    public void removeDragSourceMotionListener(DragSourceMotionListener  dsml)

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

  `
  파라미터:
    `dsml` - 삭제하는 `DragSourceMotionListener`
  도입된 버젼:
    1.4
  관련 항목:
    `addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)` , `getDragSourceMotionListeners()`

### getDragSourceMotionListeners

    public DragSourceMotionListener [] getDragSourceMotionListeners()

  이 `DragSource` 에 등록된 모든 `DragSourceMotionListener` 를 가져옵니다.

  반환값:
    이 `DragSource` 의 모든 `DragSourceMotionListener`. 해당하는 청취자가 현재 등록되지 않은 경우는, 빈 상태(empty)의 배열
  도입된 버젼:
    1.4
  관련 항목:
    `addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)` , `removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener)`

### getListeners

    public <T extends EventListener > T[] getListeners(Class <T> listenerType)

  이 `DragSource` 에 `FooListener` 로서 현재 등록되어 모든 객체를 가져옵니다. `FooListener` 는,`addFooListener` 메소드를 사용해 등록합니다.

  파라미터:
    `listenerType` - 요구되는 청취자의 형태. ``java.util.EventListener` 의 하위 인터페이스를 지정 ```
  반환값:
    이 컴퍼넌트에 `FooListener` 로서 등록되어 모든 객체의 배열. 이 `DragSource` 에 `FooListener` 로서 등록되어 모든 객체의 배열. 해당하는 청취자가 추가되어 있지 않은 경우는, 빈 상태(empty)의 배열
  예외:
    ``ClassCastException`` - `listenerType` 가 `java.util.EventListener` 를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우 ``
  도입된 버젼:
    1.4
  관련 항목:
    `getDragSourceListeners()` , `getDragSourceMotionListeners()`

### getDragThreshold

    public static int getDragThreshold()

  드래그 제스처(gesture) 모션의 임계치를 돌려줍니다. 드래그 제스처(gesture) 모션의 임계치는,`MouseDragGestureRecognizer` 의 추천 되는 동작을 정의합니다.

  시스템 프로퍼티 `awt.dnd.drag.threshold` 가 정의 정수로 설정되어 있는 경우, 이 메소드는 시스템 프로퍼티의 값을 돌려줍니다. 정의 정수 이외의 경우는, 관련하는 데스크탑 프로퍼티을 사용할 수 있어 Java 플랫폼의 구현으로 지원되고 있으면, 그 프로퍼티치를 돌려줍니다. 관련하는 데스크탑 프로퍼티을 사용할 수 없는 경우는, 디폴트 값를 돌려줍니다. 관련하는 데스크탑 프로퍼티은 `java.awt.Toolkit.getDesktopProperty("DnD.gestureMotionThreshold")` 를 사용해 조회할 수 있습니다.

  반환값:
    드래그 제스처(gesture) 모션의 임계치
  도입된 버젼:
    1.5
  관련 항목:
    `MouseDragGestureRecognizer`

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.