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

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

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 합니다.

정의:

인터페이스 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()

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