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 는 유효치는 아니고 무시된다