java.awt.dnd
클래스 DropTarget

java.lang.Object 
  |
  +--java.awt.dnd.DropTarget

모든 구현 인터페이스:

DropTargetListener , EventListener , Serializable

public class DropTarget

extends Object

implements DropTargetListener , Serializable

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

도입된 버젼:

1.2

관련 항목:

직렬화 된 형식

중첩된 클래스의 개요

protected static class

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

생성자의 개요

DropTarget ()
DropTarget 를 구축합니다.

DropTarget (Component c, DropTargetListener dtl)
지정된 Component 에 DropTarget 를 구축해, 이벤트 처리를 취급하는 DropTargetListener 를 관련짓습니다.

DropTarget (Component c, int ops, DropTargetListener dtl)
지정된 Component 에 DropTarget 를 구축해, 서포트하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener 를 관련짓습니다.

DropTarget (Component c, int ops, DropTargetListener dtl, boolean act)
지정된 Component 에 DropTarget 를 구축해, 서포트하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener, 그리고 DropTarget 가 현재 드롭을 받아들일지 어떨지를 나타내는 boolean 를 관련짓습니다.

DropTarget (Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm)
지정된 Component 에 새로운 DropTarget 를 구축해, 서포트하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener,DropTarget 가 현재 드롭을 받아들일지 어떨지를 나타내는 boolean, 그리고 사용하는 FlavorMap (또는 null)를 관련짓습니다.

메소드의 개요

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) DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 dragEnter() 통지를 차단합니다.
void	dragExit (DropTargetEvent dte) DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 dragExit() 통지를 차단합니다.
void	dragOver (DropTargetDragEvent dtde) DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 dragOver() 통지를 차단합니다.
void	drop (DropTargetDropEvent dtde) DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 drop() 통지를 차단합니다.
void	dropActionChanged (DropTargetDragEvent dtde) DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 dropActionChanged() 통지를 차단합니다.
Component	getComponent () 이 메소드는 이 DropTarget 에 관련한 Component 를 돌려줍니다.
int	getDefaultActions () 이 메소드는 이 DropTarget 로 서포트된 현재의 액션을 나타내는 int 를 돌려줍니다.
DropTargetContext	getDropTargetContext () 이 메소드는 이 DropTarget 에 관련한 DropTargetContext 를 돌려줍니다.
FlavorMap	getFlavorMap () 이 메소드는 이 DropTarget 에 관련한 FlavorMap 를 돌려줍니다.
protected void	initializeAutoscrolling (Point p) 자동 스크롤을 초기화합니다.
boolean	isActive () 이 메소드는 이 DropTarget 가 현재 액티브한 (드롭을 받아들일 준비가 되어 있다) 화도인지를 나타내는 boolean 를 돌려줍니다.
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 에 새로운 DropTarget 를 구축해, 서포트하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener,DropTarget 가 현재 드롭을 받아들일지 어떨지를 나타내는 boolean, 그리고 사용하는 FlavorMap (또는 null)를 관련짓습니다.

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

파라미터:

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

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

dtl - 이 DropTarget 의 DropTargetListener

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

fm - 사용하는 FlavorMap, 또는 null

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

DropTarget

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

지정된 Component 에 DropTarget 를 구축해, 서포트하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener, 그리고 DropTarget 가 현재 드롭을 받아들일지 어떨지를 나타내는 boolean 를 관련짓습니다.

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 에 DropTarget 를 구축해, 이벤트 처리를 취급하는 DropTargetListener 를 관련짓습니다.

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 에 DropTarget 를 구축해, 서포트하는 디폴트의 허용 액션을 나타내는 int, 이벤트 처리를 취급하는 DropTargetListener 를 관련짓습니다.

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 가 현재 액티브한 (드롭을 받아들일 준비가 되어 있다) 화도인지를 나타내는 boolean 를 돌려줍니다.

반환값:

DropTarget 가 액티브한가 어떤가

addDropTargetListener

public void addDropTargetListener(DropTargetListener  dtl)
                           throws TooManyListenersException 

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

파라미터:

dtl - 새로운 DropTargetListener

예외:

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

TooManyListenersException

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener  dtl)

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

파라미터:

dtl - 등록을 해제하는 DropTargetListener

dragEnter

public void dragEnter(DropTargetDragEvent  dtde)

DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 dragEnter() 통지를 차단합니다.

정의:

인터페이스 DropTargetListener 내의 dragEnter

파라미터:

dtde - DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent  dtde)

DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 dragOver() 통지를 차단합니다.

정의:

인터페이스 DropTargetListener 내의 dragOver

파라미터:

dtde - DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent  dtde)

DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 dropActionChanged() 통지를 차단합니다.

정의:

인터페이스 DropTargetListener 내의 dropActionChanged

파라미터:

dtde - DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent  dte)

DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 dragExit() 통지를 차단합니다.

정의:

인터페이스 DropTargetListener 내의 dragExit

파라미터:

dte - DropTargetEvent

drop

public void drop(DropTargetDropEvent  dtde)

DropTarget 는 등록되어 있는 DropTargetListener 가 취득하기 전에 drop() 통지를 차단합니다.

정의:

인터페이스 DropTargetListener 내의 drop

파라미터:

dtde - DropTargetDropEvent

getFlavorMap

public FlavorMap  getFlavorMap()

이 메소드는 이 DropTarget 에 관련한 FlavorMap 를 돌려줍니다.

반환값:

이 DropTarget 의 FlavorMap

setFlavorMap

public void setFlavorMap(FlavorMap  fm)

이 메소드는 이 DropTarget 에 관련한 FlavorMap 를 설정합니다.

파라미터:

fm - 새로운 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()

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