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

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

JavaTM Platform
Standard Ed. 6

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

## java.awt.dnd
인터페이스 DropTargetListener

모든 슈퍼 인터페이스:
  EventListener

기존의 구현 클래스의 일람:
  DropTarget , DropTargetAdapter

    public interface DropTargetListener

extends EventListener

`DropTargetListener` 인터페이스는, 대상의 `DropTarget` 를 포함한 DnD 조작의 통지를 `DropTarget` 클래스가 제공하는데 사용하는 콜백 인터페이스입니다. 이 인터페이스의 메소드를 구현하면(자), 드래그＆드롭 조작중에 시각적인 「드래그 언더」피드백을 사용자에게 제공할 수 있습니다.

이 인터페이스를 구현해 청취자 객체를 작성 후, 청취자 객체를 `DropTarget` 에 등록합니다. 드래그에 의해 `DropTarget` 의 드롭 사이트의 조작 가능한 부분이 입력, 이동, 또는 종료되거나 드롭 액션이 변경되거나 드롭이 발생하거나 하면(자), 청취자 객체의 관련하는 메소드가 불려 가 그 메소드에 `DropTargetEvent` 가 건네받습니다.

`DropTarget` 의 드롭 사이트의 조작 가능한 부분이란, 관련하는 `Component` 의 기하학적 도형의 일부로, 겹치고 있는 최상정도의 윈도우나, 관련하는 액티브한 `DropTarget` 를 가지는, Z-Order 가 고위인 다른 `Component` 로 숨겨지지 않은 부분입니다.

드래그시에, 현재의 드래그 조작에 관련하는 데이터는, 청취자의 메소드에게 건네지는 `DropTargetDragEvent` 인스턴스로 `getTransferable()` 를 호출하는 것에 의해, 취득할 수 있습니다.

`DropTargetDragEvent` 인스턴스의 `getTransferable()` 는, 각 청취자의 메소드내에서만 호출할 필요가 있어, 그 메소드가 돌아오기 전에, 반환되는 `Transferable` 로부터 모든 필요한 데이터를 취득할 필요가 있는 것에 주의해 주세요.

도입된 버젼:
  1.2

메소드의 개요
`void` | `dragEnter (DropTargetDragEvent dtde)` 드래그 조작중에, 청취자에게 등록된 `DropTarget` 의 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 들어갔을 때에 불려 갑니다.
`void` | `dragExit (DropTargetEvent dte)` 드래그 조작중에, 청취자에게 등록된 `DropTarget` 의 드롭 사이트의 조작 가능한 부분으로부터 마우스 포인터가 나왔을 때에 불려 갑니다.
`void` | `dragOver (DropTargetDragEvent dtde)` 드래그 조작중에, 청취자에게 등록된 `DropTarget`의 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 아직 있을 때 불려 갑니다.``
`void` | `drop (DropTargetDropEvent dtde)` 청취자에게 등록된 `DropTarget` 의 드롭 사이트의 조작 가능한 부분에의 드롭으로 드래그 조작이 종료했을 때에 불려 갑니다.
`void` | `dropActionChanged (DropTargetDragEvent dtde)` 사용자가 현재의 드롭 제스처(gesture)를 변경했을 경우에 불려 갑니다.

메소드의 상세

### dragEnter

    void dragEnter(DropTargetDragEvent  dtde)

  드래그 조작중에, 청취자에게 등록된 `DropTarget` 의 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 들어갔을 때에 불려 갑니다.

  파라미터:
    `dtde` - `DropTargetDragEvent`

### dragOver

    void dragOver(DropTargetDragEvent  dtde)

  드래그 조작중에, 청취자에게 등록된 `DropTarget`의 드롭 사이트의 조작 가능한 부분에 마우스 포인터가 아직 있을 때 불려 갑니다.

  ``
  파라미터:
    `dtde` - `DropTargetDragEvent`

### dropActionChanged

    void dropActionChanged(DropTargetDragEvent  dtde)

  사용자가 현재의 드롭 제스처(gesture)를 변경했을 경우에 불려 갑니다.

  파라미터:
    `dtde` - `DropTargetDragEvent`

### dragExit

    void dragExit(DropTargetEvent  dte)

  드래그 조작중에, 청취자에게 등록된 `DropTarget` 의 드롭 사이트의 조작 가능한 부분으로부터 마우스 포인터가 나왔을 때에 불려 갑니다.

  파라미터:
    `dte` - `DropTargetEvent`

### drop

    void drop(DropTargetDropEvent  dtde)

  청취자에게 등록된 `DropTarget` 의 드롭 사이트의 조작 가능한 부분에의 드롭으로 드래그 조작이 종료했을 때에 불려 갑니다.

  이 메소드는, 제스처(gesture)에 관련한 데이터의 확실한 전송을 담당합니다. `DropTargetDropEvent` 는, 전송 대상의 데이터 객체를 나타내는 `Transferable` 객체를 취득하는 수단을 제공합니다.

  `DropTargetDropEvent` 파라미터의 acceptDrop(int dropAction) 메소드 또는 rejectDrop() 메소드를 사용해,`DropTargetListener` 는 이 메소드로부터 드롭을 받아들이는지, 또는 거부합니다.

  acceptDrop()보다 전은 아니고 후에,`DropTargetDropEvent` 의 getTransferable() 메소드가 불려 가 반환된 `Transferable` 의 getTransferData() 메소드를 사용해 데이터 변환을 합니다.

  드롭의 완료시에는, 이 메소드의 구현은,`DropTargetDropEvent` 의 dropComplete(boolean success)에 해당의 `boolean` 를 건네주는 것에 의해, 드롭의 성공 또는 실패를 통지할 필요가 있습니다.

  주:`DropTargetDropEvent` 의 dropComplete(boolean success) 메소드를 호출하기 전에, 데이터 전송이 완료할 필요가 있습니다. 그 후, 데이터 전송이 로컬의 경우에만, 즉 `DropTargetDropEvent.isLocalTransfer()` 가 `true` 를 돌려주는 경우에만,`DropTargetDropEvent.getTransferable()` 가 돌려주는 `Transferable` 의 getTransferData() 메소드의 호출의 성공이 보증됩니다. 그렇지 않은 경우, 호출의 동작은 구현에 의존합니다.

  파라미터:
    `dtde` - `DropTargetDropEvent`

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