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

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

JavaTM Platform
Standard Ed. 6

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

## java.awt.dnd
클래스 DragGestureRecognizer

    java.lang.Object
      java.awt.dnd.DragGestureRecognizer

모든 구현된 인터페이스:
  Serializable

직계의 기존의 서브 클래스:
  MouseDragGestureRecognizer

    public abstract class DragGestureRecognizer

extends Object
implements Serializable

`DragGestureRecognizer` 는, 플랫폼 의존의 드래그 개시 제스처(gesture)를 식별하기 위해서, 특정의 `Component` 에 관련지을 수가 있는, 플랫폼 의존의 청취자를 지정하기 위한 추상 base class입니다.

적절한 `DragGestureRecognizer` 의 서브 클래스는, 특정의 `Component` 에 관련지을 수 있고 있는 `DragSource`, 또는 createDragGestureRecognizer() 메소드를 개입시켜 `Toolkit` 객체로부터 취득됩니다.

특정의 `Component` 에 관련지을 수 있으면(자),`DragGestureRecognizer` 는 `Component` 에 보내지는 입력 이벤트를 추적하기 위해서, 그 `Component` 에 적절한 청취자 인터페이스를 등록합니다.

`Component` 로 이벤트의 순서를 드래그 개시 제스처(gesture)로서 식별하면(자),`DragGestureRecognizer` 는 gestureRecognized() 메소드를 호출해 그 uni-cast `DragGestureListener` 에 통지합니다.

구상 `DragGestureRecognizer` 인스턴스가, 관련지을 수 있고 있는 `Component` 로 드래그 개시 제스처(gesture)를 검출하면(자),`DragGestureListener` 이벤트의 uni-cast 이벤트 소스에 등록되어 있는 `DragGestureListener` 에 `DragGestureEvent` 를 트리거합니다. 이 `DragGestureListener` 는, 관련지을 수 있었던 `DragSource` 에 필요에 따라서 드래그＆드롭 조작의 개시를 유발 (prompt)합니다.

관련 항목:
  `DragGestureListener` , `DragGestureEvent` , `DragSource` , 직렬화 된 형식

필드의 개요
`protected Component` | `component` `DragGestureRecognizer` 에 관련한 `Component` 입니다.
`protected DragGestureListener` | `dragGestureListener` `DragGestureRecognizer` 에 관련한 `DragGestureListener` 입니다.
`protected DragSource` | `dragSource` `DragGestureRecognizer` 에 관련한 `DragSource` 입니다.
`protected ArrayList <InputEvent >` | `events` 드래그를 트리거하는 「제스처(gesture)」로서 `DragGestureRecognizer` 이 「인식된다」같게 하는 이벤트의 리스트입니다.
`protected int` | `sourceActions` 드래그＆드롭 조작으로 사용하는 액션의 형식을 나타내는 `int` 입니다.

생성자 의 개요
`protected` | `DragGestureRecognizer (DragSource ds)` 이 드래그＆드롭 조작에 사용하는 `DragSource` 를 지정해 새로운 `DragGestureRecognizer` 를 구축합니다.
`protected` | `DragGestureRecognizer (DragSource ds, Component c)` 이 드래그＆드롭 조작에 사용하는 `DragSource`, 이 `DragGestureRecognizer` 가 드래그 개시 제스처(gesture)를 「감시」할 수 있는 `Component` 를 지정해 새로운 `DragGestureRecognizer` 를 구축합니다.
`protected` | `DragGestureRecognizer (DragSource ds, Component c, int sa)` 이 드래그＆드롭 조작에 사용하는 `DragSource`, 이 `DragGestureRecognizer` 가 드래그 개시 제스처(gesture)를 「감시」할 수 있는 `Component`, 이 드래그＆드롭 조작을 지원하는 액션을 지정해 새로운 `DragGestureRecognizer` 를 구축합니다.
`protected` | `DragGestureRecognizer (DragSource ds, Component c, int sa, DragGestureListener dgl)` 이 드래그＆드롭 조작에 사용하는 `DragSource`, 이 `DragGestureRecognizer` 가 드래그 개시 제스처(gesture)를 「감시」할 수 있는 `Component`, 이 드래그＆드롭 조작을 지원하는 액션, 및 `DragGestureListener` 를 지정해 새로운 `DragGestureRecognizer` 를 구축해, 드래그 개시 제스처(gesture)를 검출한 것을 한 번 통지합니다.

메소드의 개요
`void` | `addDragGestureListener (DragGestureListener dgl)` 새로운 `DragGestureListener` 를 등록합니다.
`protected void` | `appendEvent (InputEvent awtie)` 이 Recognizer 에 의해 Component 로 등록된 청취자는, 이 API 를 개입시켜, 드래그＆드롭 개시 제스처(gesture)를 구성하는 일련의 이벤트의 일부로서 인식되는 모든 이벤트를 기록합니다.
`protected void` | `fireDragGestureRecognized (int dragAction, Point p)` 드래그＆드롭 개시 제스처(gesture)가 발생한 것을 DragGestureListener 에 통지합니다.
`Component` | `getComponent ()` 이 메소드는, 드래그 개시 제스처(gesture)를 `DragGestureRecognizer` 에 「감시」되는 `Component` 를 돌려줍니다.
`DragSource` | `getDragSource ()` 이 메소드는, 이 `DragGestureRecognizer` 이, 드래그＆드롭 조작을 처리하기 위해서 사용하는 `DragSource` 를 돌려줍니다.
`int` | `getSourceActions ()` 이 메소드는, 이 드래그＆드롭 조작이 지원하는 액션의 형식을 나타내는 int 를 돌려줍니다.
`InputEvent` | `getTriggerEvent ()` 이 메소드는, 드래그＆드롭 조작을 개시한 일련의 이벤트의 최초의 이벤트를 돌려줍니다.
`protected abstract void` | `registerListeners ()` 이 DragGestureRecognizer 의 청취자를 Component 에 등록합니다.
`void` | `removeDragGestureListener (DragGestureListener dgl)` 현재의 DragGestureListener 의 등록을 해제합니다.
`void` | `resetRecognizer ()` Recognizer 를 취소합니다.
`void` | `setComponent (Component c)` DragGestureRecognizer 를 관련지을 수 있는 Component 를 설정합니다.
`void` | `setSourceActions (int actions)` 이 메소드는 드래그＆드롭 조작에 허가되고 있는 소스 드래그 액션을 설정합니다.
`protected abstract void` | `unregisterListeners ()` 이 DragGestureRecognizer 의 청취자를 Component 로부터 등록 해제합니다.

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait`

필드의 상세

### dragSource

    protected DragSource  dragSource

  `DragGestureRecognizer` 에 관련한 `DragSource` 입니다.

### component

    protected Component  component

  `DragGestureRecognizer` 에 관련한 `Component` 입니다.

### dragGestureListener

    protected transient DragGestureListener  dragGestureListener

  `DragGestureRecognizer` 에 관련한 `DragGestureListener` 입니다.

### sourceActions

    protected int sourceActions

  드래그＆드롭 조작으로 사용하는 액션의 형식을 나타내는 `int` 입니다.

### events

    protected ArrayList <InputEvent > events

  드래그를 트리거하는 「제스처(gesture)」로서 `DragGestureRecognizer` 이 「인식된다」같게 하는 이벤트의 리스트입니다.

생성자 의 상세

### DragGestureRecognizer

    protected DragGestureRecognizer(DragSource  ds,
                                    Component  c,
                                    int sa,
                                    DragGestureListener  dgl)

  이 드래그＆드롭 조작에 사용하는 `DragSource`, 이 `DragGestureRecognizer` 가 드래그 개시 제스처(gesture)를 「감시」할 수 있는 `Component`, 이 드래그＆드롭 조작을 지원하는 액션, 및 `DragGestureListener` 를 지정해 새로운 `DragGestureRecognizer` 를 구축해, 드래그 개시 제스처(gesture)를 검출한 것을 한 번 통지합니다.

  파라미터:
    `ds` - 이 `DragGestureRecognizer` 가, 드래그＆드롭 조작을 처리하기 위해서 사용하는 `DragSource`
    `c` - `Component` 이 `DragGestureRecognizer` 이 드래그 개시 제스처(gesture)를 검출하기 위해서 이벤트 스트림을 「감시」하는 `Component`. 이 값이 `null` 의 경우, `DragGestureRecognizer` 는, 어느 `Component` 에도 관련지을 수 있지 않은
    `sa` - 이 드래그＆드롭 조작이 지원한다 `DnDConstants` 의 세트 (논리합)
    `dgl` - 드래그 제스처(gesture)가 검출되었을 때에 통지한다 `DragGestureRecognizer`

  예외:
    ``IllegalArgumentException`` - ds 가 `null` 의 경우

### DragGestureRecognizer

    protected DragGestureRecognizer(DragSource  ds,
                                    Component  c,
                                    int sa)

  이 드래그＆드롭 조작에 사용하는 `DragSource`, 이 `DragGestureRecognizer` 가 드래그 개시 제스처(gesture)를 「감시」할 수 있는 `Component`, 이 드래그＆드롭 조작을 지원하는 액션을 지정해 새로운 `DragGestureRecognizer` 를 구축합니다.

  파라미터:
    `ds` - 이 `DragGestureRecognizer` 가, 드래그＆드롭 조작을 처리하기 위해서 사용하는 `DragSource`
    `c` - 이 `DragGestureRecognizer` 가 드래그 개시 제스처(gesture)를 검출하기 위해서 이벤트 스트림을 「감시」하는 `Component`. 이 값이 `null` 의 경우, `DragGestureRecognizer` 는, 어느 `Component` 에도 관련지을 수 있지 않은
    `sa` - 이 드래그＆드롭 조작이 지원한다 `DnDConstants` 세트 (논리합)

  예외:
    ``IllegalArgumentException`` - ds 가 `null` 의 경우

### DragGestureRecognizer

    protected DragGestureRecognizer(DragSource  ds,
                                    Component  c)

  이 드래그＆드롭 조작에 사용하는 `DragSource`, 이 `DragGestureRecognizer` 가 드래그 개시 제스처(gesture)를 「감시」할 수 있는 `Component` 를 지정해 새로운 `DragGestureRecognizer` 를 구축합니다.

  파라미터:
    `ds` - 이 `DragGestureRecognizer` 가, 드래그＆드롭 조작을 처리하기 위해서 사용하는 `DragSource`
    `c` - `Component` 이 `DragGestureRecognizer` 이 드래그 개시 제스처(gesture)를 검출하기 위해서 이벤트 스트림을 「감시」하는 `Component`. 이 값이 `null` 의 경우, `DragGestureRecognizer` 는, 어느 `Component` 에도 관련지을 수 있지 않았다

  예외:
    ``IllegalArgumentException`` - ds 가 `null` 의 경우

### DragGestureRecognizer

    protected DragGestureRecognizer(DragSource  ds)

  이 드래그＆드롭 조작에 사용하는 `DragSource` 를 지정해 새로운 `DragGestureRecognizer` 를 구축합니다.

  파라미터:
    `ds` - 이 `DragGestureRecognizer` 가, 드래그＆드롭 조작을 처리하기 위해서 사용하는 `DragSource`

  예외:
    ``IllegalArgumentException`` - ds 가 `null` 의 경우

메소드의 상세

### registerListeners

    protected abstract void registerListeners()

  이 DragGestureRecognizer 의 청취자를 Component 에 등록합니다. 서브 클래스는 이 메소드를 오버라이드(override) 할 필요가 있습니다.

### unregisterListeners

    protected abstract void unregisterListeners()

  이 DragGestureRecognizer 의 청취자를 Component 로부터 등록 해제합니다. 서브 클래스는 이 메소드를 오버라이드(override) 할 필요가 있습니다.

### getDragSource

    public DragSource  getDragSource()

  이 메소드는, 이 `DragGestureRecognizer` 이, 드래그＆드롭 조작을 처리하기 위해서 사용하는 `DragSource` 를 돌려줍니다.

  반환값:
    DragSource

### getComponent

    public Component  getComponent()

  이 메소드는, 드래그 개시 제스처(gesture)를 `DragGestureRecognizer` 에 「감시」되는 `Component` 를 돌려줍니다.

  반환값:
    이 DragGestureRecognizer 이 관련지을 수 있고 있는 Component

### setComponent

    public void setComponent(Component  c)

  DragGestureRecognizer 를 관련지을 수 있는 Component 를 설정합니다. registerListeners() 및 unregisterListeners()는, 필요에 따라서 부작용으로서 불려 갑니다.

  파라미터:
    `c` - `Component` 또는 `null`

### getSourceActions

    public int getSourceActions()

  이 메소드는, 이 드래그＆드롭 조작이 지원하는 액션의 형식을 나타내는 int 를 돌려줍니다.

  반환값:
    현재 허가되고 있는 소스 액션

### setSourceActions

    public void setSourceActions(int actions)

  이 메소드는 드래그＆드롭 조작에 허가되고 있는 소스 드래그 액션을 설정합니다.

  파라미터:
    `actions` - 허가되고 있는 소스 드래그 액션

### getTriggerEvent

    public InputEvent  getTriggerEvent()

  이 메소드는, 드래그＆드롭 조작을 개시한 일련의 이벤트의 최초의 이벤트를 돌려줍니다.

  반환값:
    드래그 제스처(gesture)를 트리거한 초기 이벤트

### resetRecognizer

    public void resetRecognizer()

  Recognizer 를 취소합니다. 현재 제스처(gesture)를 인식하고 있는 경우는 무시됩니다.

### addDragGestureListener

    public void addDragGestureListener(DragGestureListener  dgl)
                                throws TooManyListenersException

  새로운 `DragGestureListener` 를 등록합니다.

  파라미터:
    `dgl` - 이 `DragGestureRecognizer` 에 등록하는 `DragGestureListener`

  예외:
    `TooManyListenersException` - `DragGestureListener` 가 벌써 추가되고 있는 경우

### removeDragGestureListener

    public void removeDragGestureListener(DragGestureListener  dgl)

  현재의 DragGestureListener 의 등록을 해제합니다.

  파라미터:
    `dgl` - 이 `DragGestureRecognizer` 로부터 등록을 해제하는 `DragGestureListener`

  예외:
    ``IllegalArgumentException`` - 다음의 조건이 성립하는 경우: dgl 가 현재 등록되어 있는 `DragGestureListener` 가 아닌 경우 (다른 경우)

### fireDragGestureRecognized

    protected void fireDragGestureRecognized(int dragAction,
                                             Point  p)

  드래그＆드롭 개시 제스처(gesture)가 발생한 것을 DragGestureListener 에 통지합니다. 다음에, Recognizer 상태를 취소합니다.

  파라미터:
    `dragAction` - 사용자 제스처(gesture)가 최초로 선택한 액션
    `p` - 제스처(gesture)가 발생한 포인트 (Component 의 좌표)

### appendEvent

    protected void appendEvent(InputEvent  awtie)

  이 Recognizer 에 의해 Component 로 등록된 청취자는, 이 API 를 개입시켜, 드래그＆드롭 개시 제스처(gesture)를 구성하는 일련의 이벤트의 일부로서 인식되는 모든 이벤트를 기록합니다.

  이 메소드는 `DragGestureRecognizer` 구현이 `InputEvent` 서브 클래스 (드래그＆드롭 조작을 구성하는 일련의 이벤트의 1개)를, 이 `DragGestureRecognizer` 이 내부적으로 유지하고 있는 이벤트 배열에 추가할 경우에 사용합니다.

  파라미터:
    `awtie` - 이 `DragGestureRecognizer` 의 내부 이벤트 배열에 추가하는 `InputEvent`. `null` 는 유효치는 아니고 무시된다

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 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 도 참조해 주세요.