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

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

JavaTM Platform
Standard Ed. 6

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

## java.awt.dnd
클래스 DropTargetDropEvent

    java.lang.Object
      java.util.EventObject
          java.awt.dnd.DropTargetEvent
              java.awt.dnd.DropTargetDropEvent

모든 구현된 인터페이스:
  Serializable

    public class DropTargetDropEvent

extends DropTargetEvent

`DropTargetDropEvent` 는,`DropTargetListener` 의 drop() 메소드를 개입시켜 보내집니다.

`DropTargetDropEvent` 는, 드래그＆드롭 조작의 현재 상태를 반영한 「소스 드롭 액션」과「사용자 드롭 액션」을 통지합니다.

「소스 드롭 액션」은, 이 드래그＆드롭 조작의 드래그 소스로 지원되고 있는 일련의 드롭 액션을 나타내는 `DnDConstants` 의 비트 단위의 마스크입니다.

「사용자 드롭 액션」은, 드래그 소스로 지원되는 드롭 액션과 사용자가 선택한 드롭 액션에 따라서 다릅니다. 사용자는, 드래그 조작중에 수식 키를 누르는 것으로, 드롭 액션을 선택할 수 있습니다.

       Ctrl + Shift -> ACTION_LINK
       Ctrl         -> ACTION_COPY
       Shift        -> ACTION_MOVE

사용자가 드롭 액션을 선택했을 경우, 「사용자 드롭 액션」은, 선택된 드롭 액션이 드래그 소스로 지원되고 있으면, 그 드롭 액션을 나타내는 `DnDConstants` 의 1 개입니다. 그 드롭 액션이 드래그 소스로 지원되어 있지 않으면,`DnDConstants.ACTION_NONE` 입니다.

사용자가 드롭 액션을 선택하지 않는 경우는, 드래그 소스로 지원되고 있는 일련의 드롭 액션을 나타내는 `DnDConstants` 세트로 `DnDConstants.ACTION_MOVE`,`DnDConstants.ACTION_COPY`,`DnDConstants.ACTION_LINK` 가 순서에 검색되어 「사용자 드롭 액션」은 최초로 발견되는 정수가 됩니다. 정수가 발견되지 않는 경우, 「사용자 드롭 액션」은 `DnDConstants.ACTION_NONE` 가 됩니다.

도입된 버젼:
  1.2
관련 항목:
  직렬화 된 형식

필드의 개요

클래스 java.awt.dnd. DropTargetEvent 로부터 상속된 필드
`context`

클래스 java.util. EventObject 로부터 상속된 필드
`source`

생성자 의 개요
`DropTargetDropEvent (DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)` 이 조작의 `DropTargetContext`,`Component` 의 좌표에 있는 드래그 `Cursor` 의 핫 스포트의 위치, 현재 선택되고 있는 사용자 드롭 액션, 및 전송원으로 지원되고 있는 현재의 일련의 액션을 지정해,`DropTargetDropEvent` 를 구축합니다.
`DropTargetDropEvent (DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)` 이 조작의 `DropTargetContext`,`Component` 의 좌표에 있는 드래그 `Cursor` 핫 스포트의 위치, 현재 사용자가 선택한 드롭 액션, 전송원으로 지원되고 있는 현재의 일련의 액션, 그리고 전송원이 타겟과 같은 JVM 에 있을지 어떨지를 나타내는 `boolean` 로 지정해,`DropTargetEvent` 을 구축합니다.

메소드의 개요
`void` | `acceptDrop (int dropAction)` 지정된 액션을 사용해, 드롭을 받아들입니다.
`void` | `dropComplete (boolean success)` 이 메소드는, 드롭 전송이 완료한 것을 `DragSource` 에 통지합니다.
`DataFlavor []` | `getCurrentDataFlavors ()` 이 메소드는, 현재의 DataFlavor 를 돌려줍니다.
`List <DataFlavor >` | `getCurrentDataFlavorsAsList ()` 이 메소드는, 현재 유효한 `DataFlavor` 를 `java.util.List` 로서 돌려줍니다.
`int` | `getDropAction ()` 이 메소드는, 사용자 드롭 액션을 돌려줍니다.
`Point` | `getLocation ()` 이 메소드는,`Component` 의 좌표로 `Cursor` 의 현재의 위치를 나타내는 `Point` 를 돌려줍니다.
`int` | `getSourceActions ()` 이 메소드는, 소스 드롭 액션을 돌려줍니다.
`Transferable` | `getTransferable ()` 이 메소드는, 드롭에 관련한 `Transferable` 객체를 돌려줍니다.
`boolean` | `isDataFlavorSupported (DataFlavor df)` 이 메소드는, 지정한 `DataFlavor` 가 전송원으로 유효한가 어떤가를 나타내는 `boolean` 를 돌려줍니다.
`boolean` | `isLocalTransfer ()` 이 메소드는, 전송원이 타겟과 같은 JVM 에 있을지 어떨지를 나타내는 `int` 를 돌려줍니다.
`void` | `rejectDrop ()` 드롭을 거부합니다.

클래스 java.awt.dnd. DropTargetEvent 로부터 상속된 메소드
`getDropTargetContext`

클래스 java.util. EventObject 로부터 상속된 메소드
`getSource , toString`

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait`

생성자 의 상세

### DropTargetDropEvent

    public DropTargetDropEvent(DropTargetContext  dtc,
                               Point  cursorLocn,
                               int dropAction,
                               int srcActions)

  이 조작의 `DropTargetContext`,`Component` 의 좌표에 있는 드래그 `Cursor` 의 핫 스포트의 위치, 현재 선택되고 있는 사용자 드롭 액션, 및 전송원으로 지원되고 있는 현재의 일련의 액션을 지정해,`DropTargetDropEvent` 를 구축합니다. 디폴트에서는 이 생성자 은, 타겟이 전송원과 같은 가상 머신에 없는 것이라고 봅니다. 즉 `isLocalTransfer()` 가 `false` 를 돌려줍니다.

  파라미터:
    `dtc` - 이 조작의 `DropTargetContext`
    `cursorLocn` - `Component` 의 좌표에서의, 「드래그」커서의 핫 스포트의 위치
    `dropAction` - 사용자 드롭 액션
    `srcActions` - 소스 드롭 액션
  예외:
    ``NullPointerException`` - cursorLocn 가 `null` 의 경우
    ``IllegalArgumentException`` - dropAction 가 `DnDConstants` 의 어떤 것도 아닌 경우
    ``IllegalArgumentException`` - srcActions 가 `DnDConstants` 의 비트 단위의 마스크가 아닌 경우
    ``IllegalArgumentException`` - dtc 가 `null` 의 경우

### DropTargetDropEvent

    public DropTargetDropEvent(DropTargetContext  dtc,
                               Point  cursorLocn,
                               int dropAction,
                               int srcActions,
                               boolean isLocal)

  이 조작의 `DropTargetContext`,`Component` 의 좌표에 있는 드래그 `Cursor` 핫 스포트의 위치, 현재 사용자가 선택한 드롭 액션, 전송원으로 지원되고 있는 현재의 일련의 액션, 그리고 전송원이 타겟과 같은 JVM 에 있을지 어떨지를 나타내는 `boolean` 로 지정해,`DropTargetEvent` 을 구축합니다.

  파라미터:
    `dtc` - 이 조작의 DropTargetContext
    `cursorLocn` - Component 의 좌표에서의, 「드래그」커서의 핫 스포트의 위치
    `dropAction` - 사용자 드롭 액션
    `srcActions` - 소스 드롭 액션
    `isLocal` - 전송원이 타겟과 같은 JVM 에 있는 경우는 true
  예외:
    ``NullPointerException`` - cursorLocn 가 `null` 의 경우
    ``IllegalArgumentException`` - dropAction 가 `DnDConstants` 의 어떤 것도 아닌 경우
    ``IllegalArgumentException`` - srcActions 가 `DnDConstants` 의 비트 단위의 마스크가 아닌 경우
    ``IllegalArgumentException`` - dtc 가 `null` 의 경우

메소드의 상세

### getLocation

    public Point  getLocation()

  이 메소드는,`Component` 의 좌표로 `Cursor` 의 현재의 위치를 나타내는 `Point` 를 돌려줍니다.

  반환값:
    Component 의 좌표에서의, 현재의 `Cursor` 위치

### getCurrentDataFlavors

    public DataFlavor [] getCurrentDataFlavors()

  이 메소드는, 현재의 DataFlavor 를 돌려줍니다.

  반환값:
    현재의 DataFlavor

### getCurrentDataFlavorsAsList

    public List <DataFlavor > getCurrentDataFlavorsAsList()

  이 메소드는, 현재 유효한 `DataFlavor` 를 `java.util.List` 로서 돌려줍니다.

  반환값:
    현재의 유효한 DataFlavor 의 java.util.List

### isDataFlavorSupported

    public boolean isDataFlavorSupported(DataFlavor  df)

  이 메소드는, 지정한 `DataFlavor` 가 전송원으로 유효한가 어떤가를 나타내는 `boolean` 를 돌려줍니다.

  파라미터:
    `df` - 판정 대상의 `DataFlavor`

  반환값:
    지정된 DataFlavor 가 소스로 유효한 경우

### getSourceActions

    public int getSourceActions()

  이 메소드는, 소스 드롭 액션을 돌려줍니다.

  반환값:
    소스 드롭 액션

### getDropAction

    public int getDropAction()

  이 메소드는, 사용자 드롭 액션을 돌려줍니다.

  반환값:
    사용자 드롭 액션

### getTransferable

    public Transferable  getTransferable()

  이 메소드는, 드롭에 관련한 `Transferable` 객체를 돌려줍니다.

  반환값:
    드롭에 관련한 `Transferable`

### acceptDrop

    public void acceptDrop(int dropAction)

  지정된 액션을 사용해, 드롭을 받아들입니다.

  파라미터:
    `dropAction` - 지정된 액션

### rejectDrop

    public void rejectDrop()

  드롭을 거부합니다.

### dropComplete

    public void dropComplete(boolean success)

  이 메소드는, 드롭 전송이 완료한 것을 `DragSource` 에 통지합니다.

  파라미터:
    `success` - 드롭 전송이 완료한 것을 나타내는 `boolean`

### isLocalTransfer

    public boolean isLocalTransfer()

  이 메소드는, 전송원이 타겟과 같은 JVM 에 있을지 어떨지를 나타내는 `int` 를 돌려줍니다.

  반환값:
    Source 가 같은 JVM 에 있을지 어떨지

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 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 도 참조해 주세요.