|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 | |||||||||
java.lang.Objectjava.awt.dnd.DragSource
public class DragSource
DragSource 는, 드래그&드롭 조작의 개시를 담당하는 엔티티로, 다음과 같은 몇개의 시나리오로 사용할 수 있습니다.
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 에 관해서, 조작중은 그 조작은 일정하고 있습니다.
| 필드의 개요 | |
|---|---|
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 를 설정합니다. |
|
|
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 를 돌려줍니다. |
|
|
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 |
| 필드의 상세 |
|---|
public static final Cursor DefaultCopyDrop
Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는,null 입니다.
GraphicsEnvironment.isHeadless() public static final Cursor DefaultMoveDrop
Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는,null 입니다.
GraphicsEnvironment.isHeadless() public static final Cursor DefaultLinkDrop
Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는,null 입니다.
GraphicsEnvironment.isHeadless() public static final Cursor DefaultCopyNoDrop
Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는,null 입니다.
GraphicsEnvironment.isHeadless() public static final Cursor DefaultMoveNoDrop
Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는,null 입니다.
GraphicsEnvironment.isHeadless() public static final Cursor DefaultLinkNoDrop
Cursor 입니다. GraphicsEnvironment.isHeadless() 가 true 를 돌려주는 경우는,null 입니다.
GraphicsEnvironment.isHeadless() | 생성자 의 상세 |
|---|
public DragSource()
throws HeadlessException
DragSource 를 생성합니다.
HeadlessException - GraphicsEnvironment.isHeadless()가
true 를 돌려주는 경우GraphicsEnvironment.isHeadless() | 메소드의 상세 |
|---|
public static DragSource getDefaultDragSource()
DragSource 객체를 가져옵니다.
HeadlessException - GraphicsEnvironment.isHeadless()가
true 를 돌려주는 경우GraphicsEnvironment.isHeadless() public static boolean isDragImageSupported()
Image 의 지원가 가능한가 어떤가를 보고합니다.
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 - 드래그를 개시시킨 DragGestureEventdragCursor - 초기 Cursor, 또는 디폴트의 경우 nulldragImage - 드래그 하는 이미지, 또는 nullimageOffset - 트리거의 순간에 있어서의,Cursor 의 핫 스포트로부터의 Image 원점의 오프셋(offset)transferable - 드래그의 대상 데이터dsl - DragSourceListenerflavorMap - 사용하는 FlavorMap, 또는 null
java.awt.dnd.InvalidDnDOperationException - 드래그&드롭 시스템이
드래그 조작을 개시할 수 없는 경우,
또는 기존의 드래그 조작을 실행중에
사용자가 드래그를 개시하려고 했을 경우
InvalidDnDOperationException
public void startDrag(DragGestureEvent trigger,
Cursor dragCursor,
Transferable transferable,
DragSourceListener dsl,
FlavorMap flavorMap)
throws InvalidDnDOperationException
DragGestureEvent, 사용하는 초기 Cursor, 드래그의 Transferable 대상 데이터,DragSourceListener, 및 FlavorMap 를 받아, 드래그를 개시합니다.
trigger - 드래그를 개시시켰다
DragGestureEventdragCursor - 초기의 Cursor,
또는 디폴트의 경우 nulltransferable - 드래그의 대상 데이터dsl - DragSourceListenerflavorMap - 사용하는 FlavorMap, 또는 null
java.awt.dnd.InvalidDnDOperationException - 드래그&드롭 시스템이
드래그 조작을 개시할 수 없는 경우,
또는 기존의 드래그 조작을 실행중에
사용자가 드래그를 개시하려고 했을 경우
InvalidDnDOperationException
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 - 드래그를 개시시킨 DragGestureEventdragCursor - 초기 Cursor, 또는 디폴트의 경우 nulldragImage - 드래그 하는 Image, 또는 nulldragOffset - 트리거의 순간에 있어서의,Cursor 의 핫 스포트로부터의 Image 원점의 오프셋(offset)transferable - 드래그의 대상 데이터dsl - DragSourceListener
java.awt.dnd.InvalidDnDOperationException - 드래그&드롭 시스템이
드래그 조작을 개시할 수 없는 경우,
또는 기존의 드래그 조작을 실행중에
사용자가 드래그를 개시하려고 했을 경우
InvalidDnDOperationException
public void startDrag(DragGestureEvent trigger,
Cursor dragCursor,
Transferable transferable,
DragSourceListener dsl)
throws InvalidDnDOperationException
DragGestureEvent, 사용하는 초기 Cursor 드래그의 Transferable 대상 데이터, 및 DragSourceListener 를 받아, 드래그를 개시합니다.
trigger - 드래그를 개시시킨 DragGestureEventdragCursor - 초기 Cursor, 또는 디폴트의 경우 nulltransferable - 드래그의 대상 데이터dsl - DragSourceListener
java.awt.dnd.InvalidDnDOperationException - 드래그&드롭 시스템이
드래그 조작을 개시할 수 없는 경우,
또는 기존의 드래그 조작을 실행중에
사용자가 드래그를 개시하려고 했을 경우
InvalidDnDOperationException
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 - 이 드래그의 DragSourceContextPeerdgl - 드래그를 트리거했다
DragGestureEventdragCursor - 표시하는 초기 CursordragImage - 드래그 하는 Image 또는 nullimageOffset - 트리거의 순간에 있어서의,
커서의 핫 스포트로부터의 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 와 동일한 경우public FlavorMap getFlavorMap()
DragSource 의 FlavorMap 를 돌려줍니다.
DragSource 의 FlavorMap
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
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 를 돌려주었을 경우는,
nullpublic void addDragSourceListener(DragSourceListener dsl)
DragSourceListener 를 이 DragSource 에 추가해, 이 DragSource 로 개시된 드래그 조작중의 드래그 소스 이벤트를 수신합니다. null 의 청취자가 지정되었을 경우는, 아무것도 처리는 행해지지 않고, 예외는 throw 되지 않습니다.
- 파라미터:
dsl - 추가하는 DragSourceListener- 도입된 버젼:
- 1.4
- 관련 항목:
removeDragSourceListener(java.awt.dnd.DragSourceListener) ,
getDragSourceListeners()
public void removeDragSourceListener(DragSourceListener dsl)
DragSource 로부터 지정된 DragSourceListener 를 삭제합니다. null 의 청취자가 지정되었을 경우는, 아무것도 처리는 행해지지 않고, 예외는 throw 되지 않습니다. 인수로 지정된 청취자가 전에 이 DragSource 에 추가되어 있지 않은 경우는, 아무것도 처리는 행해지지 않고, 예외는 throw 되지 않습니다.
- 파라미터:
dsl - 삭제하는 DragSourceListener- 도입된 버젼:
- 1.4
- 관련 항목:
addDragSourceListener(java.awt.dnd.DragSourceListener) ,
getDragSourceListeners()
public DragSourceListener [] getDragSourceListeners()
DragSource 에 등록된 모든 DragSourceListener 를 가져옵니다.
DragSource 의
모든 DragSourceListener.
해당하는 청취자가 현재 등록되지 않은 경우는, 빈 상태(empty)의 배열addDragSourceListener(java.awt.dnd.DragSourceListener) ,
removeDragSourceListener(java.awt.dnd.DragSourceListener) public void addDragSourceMotionListener(DragSourceMotionListener dsml)
DragSourceMotionListener 를 이 DragSource 에 추가해, 이 DragSource 로 개시된 드래그 조작중의 드래그 모션 이벤트를 수신합니다. null 의 청취자가 지정되었을 경우는, 아무것도 처리는 행해지지 않고, 예외는 throw 되지 않습니다.
- 파라미터:
dsml - 추가하는 DragSourceMotionListener- 도입된 버젼:
- 1.4
- 관련 항목:
removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener) ,
getDragSourceMotionListeners()
public void removeDragSourceMotionListener(DragSourceMotionListener dsml)
DragSource 로부터 지정된 DragSourceMotionListener 를 삭제합니다. null 의 청취자가 지정되었을 경우는, 아무것도 처리는 행해지지 않고, 예외는 throw 되지 않습니다. 인수로 지정된 청취자가 전에 이 DragSource 에 추가되어 있지 않은 경우는, 아무것도 처리는 행해지지 않고, 예외는 throw 되지 않습니다.
- 파라미터:
dsml - 삭제하는 DragSourceMotionListener- 도입된 버젼:
- 1.4
- 관련 항목:
addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener) ,
getDragSourceMotionListeners()
public DragSourceMotionListener [] getDragSourceMotionListeners()
DragSource 에 등록된 모든 DragSourceMotionListener 를 가져옵니다.
DragSource 의
모든 DragSourceMotionListener.
해당하는 청취자가 현재 등록되지 않은 경우는, 빈 상태(empty)의 배열addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener) ,
removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener) 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() public static int getDragThreshold()
MouseDragGestureRecognizer 의 추천 되는 동작을 정의합니다.
시스템 프로퍼티 awt.dnd.drag.threshold 가 정의 정수로 설정되어 있는 경우, 이 메소드는 시스템 프로퍼티의 값을 돌려줍니다. 정의 정수 이외의 경우는, 관련하는 데스크탑 프로퍼티을 사용할 수 있어 Java 플랫폼의 구현으로 지원되고 있으면, 그 프로퍼티치를 돌려줍니다. 관련하는 데스크탑 프로퍼티을 사용할 수 없는 경우는, 디폴트 값를 돌려줍니다. 관련하는 데스크탑 프로퍼티은 java.awt.Toolkit.getDesktopProperty("DnD.gestureMotionThreshold") 를 사용해 조회할 수 있습니다.
MouseDragGestureRecognizer
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.