java.awt.dnd
클래스 DropTarget

java.lang.Object 
  java.awt.dnd.DropTarget

모든 구현된 인터페이스:

DropTargetListener , Serializable , EventListener

public class DropTarget
extends Object 
implements DropTargetListener , Serializable 

DropTarget 는, 드래그＆드롭 조작동안에 Component 가 드롭을 받아들이려고 할 경우에,Component 에 관련지을 수 있습니다.

각 DropTarget 는 FlavorMap 에 관련지을 수 있습니다. 그 후 FlavorMap 는 SystemFlavorMap.getDefaultFlavorMap() 에 의해 반환되는 FlavorMap 를 나타냅니다.

도입된 버젼:

1.2

관련 항목:

직렬화 된 형식

상자의 클래스의 개요

protected static class

DropTarget.DropTargetAutoScroller 이 보호 대상의 상자가 되어 있는 클래스는, 자동 스크롤을 구현합니다.

생성자 의 개요

DropTarget ()
DropTarget 를 작성합니다.

DropTarget (Component c, DropTargetListener dtl)
관련짓는 Component, 이벤트 처리를 취급하는 DropTargetListener 로,DropTarget 를 작성합니다.

DropTarget (Component c, int ops, DropTargetListener dtl)
관련짓는 Component, 지원하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener 로,DropTarget 를 작성합니다.

DropTarget (Component c, int ops, DropTargetListener dtl, boolean act)
관련짓는 Component, 지원하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener,DropTarget 가 현재 드롭을 받아들일지 어떨지를 나타내는 boolean 로부터,DropTarget 를 작성합니다.

DropTarget (Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm)
관련짓는 Component, 지원하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener,DropTarget 가 현재 드롭을 받아들일지 어떨지를 나타내는 boolean, 그리고 사용하는 FlavorMap (또는 디폴트의 FlavorMap 의 경우는 null)로부터, 새로운 DropTarget 를 작성합니다.

메소드의 개요

void	addDropTargetListener (DropTargetListener dtl) 새로운 DropTargetListener (UNICAST SOURCE)를 추가합니다.
void	addNotify (java.awt.peer.ComponentPeer peer) DropTarget 를 Component 에 관련지을 수 있고 있는 것을 그 DropTarget 에 통지합니다.
protected void	clearAutoscroll () 자동 스크롤을 클리어 합니다.
protected DropTarget.DropTargetAutoScroller	createDropTargetAutoScroller (Component c, Point p) 편입 자동 스크로라를 작성합니다.
protected DropTargetContext	createDropTargetContext () 이 DropTarget 에 관련한 DropTargetContext 를 작성합니다.
void	dragEnter (DropTargetDragEvent dtde) 등록된 DropTargetListener 로 dragEnter 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다.
void	dragExit (DropTargetEvent dte) 등록된 DropTargetListener 로 dragExit 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다.
void	dragOver (DropTargetDragEvent dtde) 등록된 DropTargetListener 로 dragOver 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다.
void	drop (DropTargetDropEvent dtde) 이 DropTarget 가 액티브한 경우는, 등록된 DropTargetListener 로 drop 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다.
void	dropActionChanged (DropTargetDragEvent dtde) 등록된 DropTargetListener 로 dropActionChanged 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다.
Component	getComponent () 이 DropTarget 에 관련지을 수 있었던 Component 를 가져옵니다.
int	getDefaultActions () DropTarget 로 지원된 현재의 액션을 나타내는 int 를 가져옵니다.
DropTargetContext	getDropTargetContext () 이 DropTarget 에 관련한 DropTargetContext 를 가져옵니다.
FlavorMap	getFlavorMap () 이 DropTarget 에 관련한 FlavorMap 를 가져옵니다.
protected void	initializeAutoscrolling (Point p) 자동 스크롤을 초기화합니다.
boolean	isActive () 이 DropTarget 가 현재 액티브한 (드롭을 받아들일 준비가 되어 있다) 화도인지를 보고합니다.
void	removeDropTargetListener (DropTargetListener dtl) 현재의 DropTargetListener (UNICAST SOURCE)를 삭제합니다.
void	removeNotify (java.awt.peer.ComponentPeer peer) DropTarget 와 Component 가 관련짓고가 해제된 것을 그 DropTarget 에 통지합니다.
void	setActive (boolean isActive) true 의 경우는 DropTarget 를 액티브하게,false 의 경우는 비액티브하게 설정합니다.
void	setComponent (Component c) 주:이 인터페이스는, DropTarget 와 Component 의 안전한 관련짓고를 다음의 2 개의 방법의 어느 쪽인지로 가능하게 할 필요가 있습니다.
void	setDefaultActions (int ops) 이 DropTarget 의 디폴트의 허용 액션을 설정합니다.
void	setFlavorMap (FlavorMap fm) 이 DropTarget 에 관련한 FlavorMap 를 설정합니다.
protected void	updateAutoscroll (Point dragCursorLocn) 현재의 커서 위치에서 자동 스크롤을 갱신합니다.

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

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

생성자 의 상세

DropTarget

public DropTarget(Component  c,
                  int ops,
                  DropTargetListener  dtl,
                  boolean act,
                  FlavorMap  fm)
           throws HeadlessException 

관련짓는 Component, 지원하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener,DropTarget 가 현재 드롭을 받아들일지 어떨지를 나타내는 boolean, 그리고 사용하는 FlavorMap (또는 디폴트의 FlavorMap 의 경우는 null)로부터, 새로운 DropTarget 를 작성합니다.

Component 는, 사용 가능한 경우만 드롭을 받습니다.

파라미터:

c - 이 DropTarget 를 관련지을 수 있는 Component

ops - 이 DropTarget 의 디폴트의 허용 액션

dtl - 이 DropTarget 의 DropTargetListener

act - DropTarget 가 드롭을 받아들일지 어떨지

fm - 사용하는 FlavorMap, 또는 디폴트의 FlavorMap 의 경우는 null

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component  c,
                  int ops,
                  DropTargetListener  dtl,
                  boolean act)
           throws HeadlessException 

관련짓는 Component, 지원하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener,DropTarget 가 현재 드롭을 받아들일지 어떨지를 나타내는 boolean 로부터,DropTarget 를 작성합니다.

Component 는, 사용 가능한 경우만 드롭을 받습니다.

파라미터:

c - 이 DropTarget 를 관련지을 수 있는 Component

ops - 이 DropTarget 의 디폴트의 허용 액션

dtl - 이 DropTarget 의 DropTargetListener

act - DropTarget 가 드롭을 받아들일지 어떨지

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget()
           throws HeadlessException 

DropTarget 를 작성합니다.

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component  c,
                  DropTargetListener  dtl)
           throws HeadlessException 

관련짓는 Component, 이벤트 처리를 취급하는 DropTargetListener 로,DropTarget 를 작성합니다.

Component 는, 사용 가능한 경우만 드롭을 받습니다.

파라미터:

c - 이 DropTarget 를 관련지을 수 있는 Component

dtl - 이 DropTarget 의 DropTargetListener

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component  c,
                  int ops,
                  DropTargetListener  dtl)
           throws HeadlessException 

관련짓는 Component, 지원하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener 로,DropTarget 를 작성합니다.

Component 는, 사용 가능한 경우만 드롭을 받습니다.

파라미터:

c - 이 DropTarget 를 관련지을 수 있는 Component

ops - 이 DropTarget 의 디폴트의 허용 액션

dtl - 이 DropTarget 의 DropTargetListener

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

setComponent

public void setComponent(Component  c)

주:이 인터페이스는, DropTarget 와 Component 의 안전한 관련짓고를 다음의 2 개의 방법의 어느 쪽인지로 가능하게 할 필요가 있습니다. component.setDropTarget(droptarget); 또는 droptarget.setComponent(component); 의 어느 쪽인지입니다.

Component 는, 사용 가능한 경우만 드롭을 받습니다.

파라미터:

c - 이 DropTarget 를 관련지을 수 있다 새로운 Component

getComponent

public Component  getComponent()

이 DropTarget 에 관련지을 수 있었던 Component 를 가져옵니다.

반환값:

현재의 Component

setDefaultActions

public void setDefaultActions(int ops)

이 DropTarget 의 디폴트의 허용 액션을 설정합니다.

파라미터:

ops - 디폴트의 액션

관련 항목:

DnDConstants

getDefaultActions

public int getDefaultActions()

DropTarget 로 지원된 현재의 액션을 나타내는 int 를 가져옵니다.

반환값:

현재의 디폴트의 액션

setActive

public void setActive(boolean isActive)

true 의 경우는 DropTarget 를 액티브하게,false 의 경우는 비액티브하게 설정합니다.

파라미터:

isActive - DropTarget 를 액티브 또는 비액티브하게 설정한다

isActive

public boolean isActive()

이 DropTarget 가 현재 액티브한 (드롭을 받아들일 준비가 되어 있다) 화도인지를 보고합니다.

반환값:

액티브한 경우는 true, 그렇지 않은 경우는 false

addDropTargetListener

public void addDropTargetListener(DropTargetListener  dtl)
                           throws TooManyListenersException 

새로운 DropTargetListener (UNICAST SOURCE)를 추가합니다.

파라미터:

dtl - 새로운 DropTargetListener

예외:

TooManyListenersException - DropTargetListener 가 벌써 이 DropTarget 에 추가되고 있는 경우

TooManyListenersException

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener  dtl)

현재의 DropTargetListener (UNICAST SOURCE)를 삭제합니다.

파라미터:

dtl - 등록을 해제하는 DropTargetListener

dragEnter

public void dragEnter(DropTargetDragEvent  dtde)

등록된 DropTargetListener 로 dragEnter 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다. 이 DropTarget 가 액티브하지 않은 경우는, 아무것도 하지 않습니다.

정의:

인터페이스 DropTargetListener 내의 dragEnter

파라미터:

dtde - DropTargetDragEvent

예외:

NullPointerException - 이 DropTarget 가 액티브해, dtde 가 null 의 경우

관련 항목:

isActive()

dragOver

public void dragOver(DropTargetDragEvent  dtde)

등록된 DropTargetListener 로 dragOver 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다. 이 DropTarget 가 액티브하지 않은 경우는, 아무것도 하지 않습니다.

정의:

인터페이스 DropTargetListener 내의 dragOver

파라미터:

dtde - DropTargetDragEvent

예외:

NullPointerException - 이 DropTarget 가 액티브해, dtde 가 null 의 경우

관련 항목:

isActive()

dropActionChanged

public void dropActionChanged(DropTargetDragEvent  dtde)

등록된 DropTargetListener 로 dropActionChanged 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다. 이 DropTarget 가 액티브하지 않은 경우는, 아무것도 하지 않습니다.

정의:

인터페이스 DropTargetListener 내의 dropActionChanged

파라미터:

dtde - DropTargetDragEvent

예외:

NullPointerException - 이 DropTarget 가 액티브해, dtde 가 null 의 경우

관련 항목:

isActive()

dragExit

public void dragExit(DropTargetEvent  dte)

등록된 DropTargetListener 로 dragExit 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다. 이 DropTarget 가 액티브하지 않은 경우는, 아무것도 하지 않습니다.

이 메소드 자체는 null 의 파라미터에 대해서 예외를 throw 하지 않습니다만, 청취자의 각 메소드에 의해 throw 되는 예외에 대해서는 예외를 throw 합니다.

정의:

인터페이스 DropTargetListener 내의 dragExit

파라미터:

dte - DropTargetEvent

관련 항목:

isActive()

drop

public void drop(DropTargetDropEvent  dtde)

이 DropTarget 가 액티브한 경우는, 등록된 DropTargetListener 로 drop 를 호출해, 지정된 DropTargetDragEvent 에 건네줍니다.

정의:

인터페이스 DropTargetListener 내의 drop

파라미터:

dtde - DropTargetDropEvent

예외:

NullPointerException - dtde 가 null 로, 이 DropTarget 가 액티브하지 않은지, 등록된DropTargetListener 가 없는 경우

관련 항목:

isActive()

getFlavorMap

public FlavorMap  getFlavorMap()

이 DropTarget 에 관련한 FlavorMap 를 가져옵니다. 이 DropTarget 에 FlavorMap 가 설정되어 있지 않은 경우는, 디폴트의 FlavorMap 에 관련지을 수 있습니다.

반환값:

이 DropTarget 의 FlavorMap

setFlavorMap

public void setFlavorMap(FlavorMap  fm)

이 DropTarget 에 관련한 FlavorMap 를 설정합니다.

파라미터:

fm - 새로운 FlavorMap. 또는 이 DropTarget 에 디폴트의 FlavorMap 를 관련짓는 경우는 null

addNotify

public void addNotify(java.awt.peer.ComponentPeer peer)

DropTarget 를 Component 에 관련지을 수 있고 있는 것을 그 DropTarget 에 통지합니다. 일반적으로, 이 메소드는 이 DropTarget 에 관련한 Component 의 java.awt.Component.addNotify()로부터 불려 가 ComponentPeer 가 그 Component 에 관련지을 수 있고 있는 것을 DropTarget 에 통지합니다. ComponentPeer 와 Component 와의 관련짓고를 DropTarget 에 통지하는 이외의 목적으로 이 메소드를 호출하면(자), DnD 시스템이 정상적으로 동작하지 않게 되는 일이 있습니다.

파라미터:

peer - 관련지을 수 있고 있는 Component 의 Peer

removeNotify

public void removeNotify(java.awt.peer.ComponentPeer peer)

DropTarget 와 Component 가 관련짓고가 해제된 것을 그 DropTarget 에 통지합니다. 일반적으로, 이 메소드는 이 DropTarget 에 관련한 Component 의 java.awt.Component.removeNotify()로부터 불려 가 ComponentPeer 와 그 Component 가 관련짓고가 해제된 것을 DropTarget 에 통지합니다. ComponentPeer 와 Component 가 관련짓고가 해제된 것을 DropTarget 에 통지하는 이외의 목적으로 이 메소드를 호출하면(자), DnD 시스템이 정상적으로 동작하지 않게 되는 일이 있습니다.

파라미터:

peer - 관련짓고가 해제되는 Component 의 Peer

getDropTargetContext

public DropTargetContext  getDropTargetContext()

이 DropTarget 에 관련한 DropTargetContext 를 가져옵니다.

반환값:

이 DropTarget 에 관련한 DropTargetContext

createDropTargetContext

protected DropTargetContext  createDropTargetContext()

이 DropTarget 에 관련한 DropTargetContext 를 작성합니다. 서브 클래스는, 이 메소드를 오버라이드(override) 해 독자적인 DropTargetContext 서브 클래스를 인스턴스화할 수 있습니다. 일반적으로, 이 호출은, 드래그 조작이 이 DropTarget 를 검출했을 때에 플랫폼의 DropTargetContextPeer 에 의해서만 불려 갑니다. 드래그가 없을 때에 Context 에 액세스 하면(자), 결과는 보증되지 않습니다.

createDropTargetAutoScroller

protected DropTarget.DropTargetAutoScroller  createDropTargetAutoScroller(Component  c,
                                                                         Point  p)

편입 자동 스크로라를 작성합니다.

파라미터:

c - Component

p - Point

initializeAutoscrolling

protected void initializeAutoscrolling(Point  p)

자동 스크롤을 초기화합니다.

파라미터:

p - Point

updateAutoscroll

protected void updateAutoscroll(Point  dragCursorLocn)

현재의 커서 위치에서 자동 스크롤을 갱신합니다.

파라미터:

dragCursorLocn - Point

clearAutoscroll

protected void clearAutoscroll()

자동 스크롤을 클리어 합니다.