java.awt.dnd
클래스 DragGestureRecognizer

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

모든 구현된 인터페이스:

Serializable

알려진 직계 서브 클래스:

MouseDragGestureRecognizer

public abstract class DragGestureRecognizer
extends Object 
implements Serializable 

DragGestureRecognizer는 플랫폼 존의 드래그 개시 제스추어를 식별하기 위해서 특정의 Component에 관련된 플랫폼 존의 리스너를 지정하기 위한 추상 base class입니다.

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

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

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

구상 DragGestureRecognizer인스턴스가 관련된 Component로 드래그 개시 제스추어를 검출하면, DragGestureListener 이벤트의 uni-cast 이벤트 소스에 등록되어 있는 DragGestureListener에 DragGestureEvent를 트리거 합니다. 이 DragGestureListener는 관련된 DragSource에 필요에 따라서 드래그＆드롭 조작의 개시를 재촉합니다.

관련 항목:

DragGestureListener, DragGestureEvent, DragSource, 직렬화 된 형식

필드 개요

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

생성자 개요

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

메서드 개요

void	addDragGestureListener (DragGestureListener dgl) 새로운 DragGestureListener를 등록합니다.
protected void	appendEvent (InputEvent awtie) 이 Recognizer에 의해 Component 로 등록된 리스너는 이 API를 개입시켜, 드래그＆드롭 개시 제스추어를 구성하는 일련의 이벤트의 일부로서 인식되는 모든 이벤트를 기록합니다.
protected void	fireDragGestureRecognized (int dragAction, Point p) 드래그＆드롭 개시 제스추어가 발생한 것을 DragGestureListener에 통지합니다.
Component	getComponent () 이 메서드는 드래그 개시 제스추어를 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

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

생성자 상세

DragGestureRecognizer

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

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

파라미터:

ds - 이 DragGestureRecognizer가 드래그＆드롭 조작을 처리하기 위해서 사용하는 DragSource

c - 이 DragGestureRecognizer가 드래그 개시 제스추어를 검출하기 위해서 이벤트 스트림을 「감시」하는 Component. 이 값이 null인 경우, DragGestureRecognizer는 어느 Component에 도 관련지을 수 있지 않은

sa - 이 드래그＆드롭 조작이 지원하는 DnDConstants 세트 (논리합)

dgl - 드래그 제스추어가 검출되었을 때에 통지하는 DragGestureRecognizer

예외:

IllegalArgumentException - ds가 null인 경우

DragGestureRecognizer

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

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

파라미터:

ds - 이 DragGestureRecognizer가 드래그＆드롭 조작을 처리하기 위해서 사용하는 DragSource

c - 이 DragGestureRecognizer가 드래그 개시 제스추어를 검출하기 위해서 이벤트 스트림을 「감시」하는 Component. 이 값이 null인 경우, DragGestureRecognizer는 어느 Component에 도 관련지을 수 있지 않은

sa - 이 드래그＆드롭 조작이 지원하는 DnDConstants 세트 (논리합)

예외:

IllegalArgumentException - ds가 null인 경우

DragGestureRecognizer

protected DragGestureRecognizer(DragSource  ds,
                                Component  c)

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

파라미터:

ds - 이 DragGestureRecognizer가 드래그＆드롭 조작을 처리하기 위해서 사용하는 DragSource

c - 이 DragGestureRecognizer가 드래그 개시 제스추어를 검출하기 위해서 이벤트 스트림을 「감시」하는 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()

이 메서드는 드래그 개시 제스추어를 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()

이 메서드는 드래그＆드롭 조작을 개시한 일련의 이벤트의 최초의 이벤트를 리턴합니다.

반환값:

드래그 제스추어를 트리거 한 초기 이벤트

resetRecognizer

public void resetRecognizer()

Recognizer를 취소합니다. 현재 제스추어를 인식하고 있는 경우는 무시됩니다.

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)

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

파라미터:

dragAction - 사용자 제스추어가 최초로 선택한 액션

p - 제스추어가 발생한 포인트 (Component 좌표)

appendEvent

protected void appendEvent(InputEvent  awtie)

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

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

파라미터:

awtie - 이 DragGestureRecognizer 내부 이벤트 배열에 추가하는 InputEvent. null은 유효값이 아니고 무시된다