java.awt.dnd
클래스 DragGestureEvent

java.lang.Object 
  java.util.EventObject 
      java.awt.dnd.DragGestureEvent

모든 구현된 인터페이스:

Serializable

public class DragGestureEvent
extends EventObject 

DragGestureEvent 는,DragGestureListener 의 dragGestureRecognized() 메소드에게 건네집니다. 이것은, 특정의 DragGestureRecognizer 가, 추적중의 Component 로 플랫폼 의존의 드래그 개시 제스처(gesture)를 검출했을 때에 행해집니다.

관련 항목:

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

필드의 개요

클래스 java.util. EventObject 로부터 상속된 필드

source

생성자 의 개요

DragGestureEvent (DragGestureRecognizer dgr, int act, Point ori, List <? extends InputEvent > evs)
이 이벤트를 트리거하는 DragGestureRecognizer 를 지정한 DragGestureEvent, 사용자의 희망하는 액션을 나타내는 int, 드래그의 기점을 나타내는 Point, 제스처(gesture)를 구성하는 이벤트의 List 를 구축합니다.

메소드의 개요

Component	getComponent () DragGestureEvent 에 관련한 Component 를 돌려줍니다.
int	getDragAction () 사용자가 선택한 액션을 나타내는 int 를 돌려줍니다.
Point	getDragOrigin () 드래그를 개시한 Component 의 좌표의 Point 를 돌려줍니다.
DragSource	getDragSource () DragSource 를 돌려줍니다.
DragGestureRecognizer	getSourceAsDragGestureRecognizer () DragGestureRecognizer 로서의 소스를 돌려줍니다.
InputEvent	getTriggerEvent () 제스처(gesture)를 트리거한 초기 이벤트를 돌려줍니다.
Iterator <InputEvent >	iterator () 제스처(gesture)를 구성하는 이벤트의 Iterator 를 돌려줍니다.
void	startDrag (Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl) 초기 Cursor 를 표시해 드래그를 개시하고 나서, 드래그 Image,Image 의 오프셋(offset),Transferable 객체와 DragSourceListener 를 사용합니다.
void	startDrag (Cursor dragCursor, Transferable transferable) 이 드래그 조작의 Cursor, 및 이 드래그 조작의 소스 데이터를 나타내는 Transferable 를 지정해, 드래그 조작을 개시합니다.
void	startDrag (Cursor dragCursor, Transferable transferable, DragSourceListener dsl) 초기 Cursor 를 표시해 드래그를 개시하고 나서,Transferable 객체와 DragSourceListener 를 사용합니다.
Object []	toArray () 드래그 제스처(gesture)를 구성하는 이벤트의 Object 의 배열을 돌려줍니다.
Object []	toArray (Object [] array) 드래그 제스처(gesture)를 구성하는 이벤트의 배열을 돌려줍니다.

클래스 java.util. EventObject 로부터 상속된 메소드

getSource , toString

클래스 java.lang. Object 로부터 상속된 메소드

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

생성자 의 상세

DragGestureEvent

public DragGestureEvent(DragGestureRecognizer  dgr,
                        int act,
                        Point  ori,
                        List <?  extends InputEvent > evs)

이 이벤트를 트리거하는 DragGestureRecognizer 를 지정한 DragGestureEvent, 사용자의 희망하는 액션을 나타내는 int, 드래그의 기점을 나타내는 Point, 제스처(gesture)를 구성하는 이벤트의 List 를 구축합니다.

파라미터:

dgr - 이 이벤트를 트리거하는 DragGestureRecognizer

act - 사용자의 희망하는 액션

ori - 드래그의 기점

evs - 제스처(gesture)를 구성하는 이벤트의 List

예외:

IllegalArgumentException - 다음의 조건이 성립하는 경우: 입력 파라미터가 null 의 경우

메소드의 상세

getSourceAsDragGestureRecognizer

public DragGestureRecognizer  getSourceAsDragGestureRecognizer()

DragGestureRecognizer 로서의 소스를 돌려줍니다.

반환값:

DragGestureRecognizer 로서의 소스

getComponent

public Component  getComponent()

DragGestureEvent 에 관련한 Component 를 돌려줍니다.

반환값:

컴퍼넌트

getDragSource

public DragSource  getDragSource()

DragSource 를 돌려줍니다.

반환값:

DragSource

getDragOrigin

public Point  getDragOrigin()

드래그를 개시한 Component 의 좌표의 Point 를 돌려줍니다.

반환값:

Component 의 좌표로 드래그가 개시된 Point

iterator

public Iterator <InputEvent > iterator()

제스처(gesture)를 구성하는 이벤트의 Iterator 를 돌려줍니다.

반환값:

제스처(gesture)를 구성하는 이벤트의 반복자

toArray

public Object [] toArray()

드래그 제스처(gesture)를 구성하는 이벤트의 Object 의 배열을 돌려줍니다.

반환값:

제스처(gesture)를 구성하는 이벤트의 배열

toArray

public Object [] toArray(Object [] array)

드래그 제스처(gesture)를 구성하는 이벤트의 배열을 돌려줍니다.

파라미터:

array - EventObject subtype의 배열

반환값:

제스처(gesture)를 구성하는 이벤트의 배열

getDragAction

public int getDragAction()

사용자가 선택한 액션을 나타내는 int 를 돌려줍니다.

반환값:

사용자가 선택한 액션

getTriggerEvent

public InputEvent  getTriggerEvent()

제스처(gesture)를 트리거한 초기 이벤트를 돌려줍니다.

반환값:

제스처(gesture) 순서에서의 최초의 「트리거」이벤트

startDrag

public void startDrag(Cursor  dragCursor,
                      Transferable  transferable)
               throws InvalidDnDOperationException 

이 드래그 조작의 Cursor, 및 이 드래그 조작의 소스 데이터를 나타내는 Transferable 를 지정해, 드래그 조작을 개시합니다. null 의 Cursor 가 지정되었을 경우는, 예외는 throw 되지 않고, 대신에 디폴트의 드래그 커서가 사용됩니다.
null 의 Transferable 이 지정되었을 경우는,NullPointerException 가 throw 됩니다.

파라미터:

dragCursor - 이 드래그 조작의 Cursor

transferable - 이 드래그 조작의 소스 데이터를 나타내는 Transferable

예외:

InvalidDnDOperationException - 드래그＆드롭 시스템이 드래그 조작을 개시할 수 없는 경우, 또는 기존의 드래그 조작을 실행중에 사용자가 드래그를 개시하려고 했을 경우

NullPointerException - Transferable 가 null 의 경우

InvalidDnDOperationException

도입된 버젼:

1.4

startDrag

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

초기 Cursor 를 표시해 드래그를 개시하고 나서,Transferable 객체와 DragSourceListener 를 사용합니다.

파라미터:

dragCursor - 초기 드래그 커서

transferable - 소스의 Transferable

dsl - 소스의 DragSourceListener

예외:

InvalidDnDOperationException - 다음의 조건이 성립하는 경우: 드래그＆드롭 시스템이 드래그 조작을 개시할 수 없는 경우, 또는 기존의 드래그 조작을 실행중에 사용자가 드래그를 개시하려고 했을 경우

InvalidDnDOperationException

startDrag

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

초기 Cursor 를 표시해 드래그를 개시하고 나서, 드래그 Image,Image 의 오프셋(offset),Transferable 객체와 DragSourceListener 를 사용합니다.

파라미터:

dragCursor - 초기 드래그 커서

dragImage - 소스의 dragImage

imageOffset - dragImage 의 오프셋(offset)

transferable - 소스의 Transferable

dsl - 소스의 DragSourceListener

예외:

InvalidDnDOperationException - 다음의 조건이 성립하는 경우: 드래그＆드롭 시스템이 드래그 조작을 개시할 수 없는 경우, 또는 기존의 드래그 조작을 실행중에 사용자가 드래그를 개시하려고 했을 경우

InvalidDnDOperationException