DropTarget (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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()

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

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.