|
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
- 드래그를 개시시킨 DragGestureEvent
dragCursor
- 초기 Cursor
, 또는 디폴트의 경우 null
dragImage
- 드래그 하는 이미지, 또는 nullimageOffset
- 트리거의 순간에 있어서의,Cursor
의 핫 스포트로부터의 Image
원점의 오프셋(offset)transferable
- 드래그의 대상 데이터dsl
- DragSourceListener
flavorMap
- 사용하는 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
- 드래그를 개시시켰다
DragGestureEvent
dragCursor
- 초기의 Cursor
,
또는 디폴트의 경우 null
transferable
- 드래그의 대상 데이터dsl
- DragSourceListener
flavorMap
- 사용하는 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
- 드래그를 개시시킨 DragGestureEvent
dragCursor
- 초기 Cursor
, 또는 디폴트의 경우 null
dragImage
- 드래그 하는 Image
, 또는 null
dragOffset
- 트리거의 순간에 있어서의,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
- 드래그를 개시시킨 DragGestureEvent
dragCursor
- 초기 Cursor
, 또는 디폴트의 경우 null
transferable
- 드래그의 대상 데이터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
- 이 드래그의 DragSourceContextPeer
dgl
- 드래그를 트리거했다
DragGestureEvent
dragCursor
- 표시하는 초기 Cursor
dragImage
- 드래그 하는 Image
또는 null
imageOffset
- 트리거의 순간에 있어서의,
커서의 핫 스포트로부터의 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
를 돌려주었을 경우는,
null
public 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 도 참조해 주세요.