java.awt.datatransfer
클래스 Clipboard

java.lang.Object 
  java.awt.datatransfer.Clipboard

public class Clipboard
extends Object 

컷/카피/페이스트 조작을 사용해, 데이터를 전송 하는 도구를 구현하는 클래스입니다.

FlavorListener를 Clipboard 클래스의 인스턴스에 등록해, 이 클립보드로 이용 가능한 일련 DataFlavor 변경에 대해 통지시킬 수가 있습니다 (addFlavorListener(java.awt.datatransfer.FlavorListener)를 참조).

관련 항목:

Toolkit.getSystemClipboard(), Toolkit.getSystemSelection()

필드 개요

protected Transferable	contents
protected ClipboardOwner	owner

생성자 개요

Clipboard (String name)
클립보드 객체를 작성합니다.

메서드 개요

void	addFlavorListener (FlavorListener listener) 클립보드로부터 FlavorEvent를 받기 위해서 지정된 FlavorListener를 등록합니다.
DataFlavor []	getAvailableDataFlavors () 클립보드의 현재의 내용을 제공할 수 있는 DataFlavor 배열을 리턴합니다.
Transferable	getContents (Object requestor) 클립보드의 현재의 내용을 표현하는 전송 가능한 객체를 리턴합니다.
Object	getData (DataFlavor flavor) 지정된 DataFlavor로 클립보드의 현재의 내용을 나타내는 객체를 리턴합니다.
FlavorListener []	getFlavorListeners () 이 Clipboard에 현재 등록되어 모든 FlavorListener 배열을 리턴합니다.
String	getName () 클립보드 객체의 이름을 리턴합니다.
boolean	isDataFlavorAvailable (DataFlavor flavor) 클립보드의 현재의 내용이 지정된 DataFlavor로 제공할 수 있을지 어떨지를 리턴합니다.
void	removeFlavorListener (FlavorListener listener) 이 Clipboard로 부터 FlavorEvent를 받지 않게, 지정된 FlavorListener를 삭제합니다.
void	setContents (Transferable contents, ClipboardOwner owner) 클립보드의 현재의 내용이 지정된 전송 가능한 객체로 설정해, 지정된 클립보드 오너를 새로운 내용의 오너로서 등록합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

owner

protected ClipboardOwner  owner

contents

protected Transferable  contents

생성자 상세

Clipboard

public Clipboard(String  name)

클립보드 객체를 작성합니다.

관련 항목:

Toolkit.getSystemClipboard()

메서드의 상세

getName

public String  getName()

클립보드 객체의 이름을 리턴합니다.

관련 항목:

Toolkit.getSystemClipboard()

setContents

public void setContents(Transferable  contents,
                        ClipboardOwner  owner)

클립보드의 현재의 내용이 지정된 전송 가능한 객체로 설정해, 지정된 클립보드 오너를 새로운 내용의 오너로서 등록합니다.

인수 owner와 다른 기존의 오너가 있는 경우, 그 오너는 그 오너의 ClipboardOwner.lostOwnership() 호출에의해 클립보드의 내용의 오나십을 잃었던 것이 통지됩니다. setContents() 구현은 이 메서드로부터 직접 lostOwnership()를 호출할 필요는 없습니다. 예를 들어 나중에 다른 thread로 lostOwnership()를 호출할 수 있습니다 . 클립보드에 등록된 FlavorListener에 도 같은 것이 들어맞읍니다.

클립보드가 현재 사용할 수 없는 경우, IllegalStateException을 Throw 합니다. 예를 들어 플랫폼에 따라서는 다른 어플리케이션이 액세스 하고 있는 동안은 시스템 클립보드를 이용할 수 없는 경우가 있습니다.

파라미터:

contents - 클립보드의 내용을 표현하는 전송 가능한 객체

owner - 클립보드의 내용을 소유하는 객체

예외:

IllegalStateException - 클립보드가 현재 사용할 수 없는 경우

관련 항목:

Toolkit.getSystemClipboard()

getContents

public Transferable  getContents(Object  requestor)

클립보드의 현재의 내용을 표현하는 전송 가능한 객체를 리턴합니다. 클립보드에 내용이 없으면, null을 리턴합니다. 파라미터 Object 요구자는 현재 사용되지 않습니다. 클립보드가 현재 사용할 수 없는 경우는 IllegalStateException을 리턴합니다. 예를 들어 플랫폼에 따라서는 다른 어플리케이션이 액세스 하고 있는 동안은 시스템 클립보드를 이용할 수 없는 경우가 있습니다.

파라미터:

requestor - 클립 데이터를 요구하는 객체 (미사용)

반환값:

클립보드상의 현재의 전송 가능한 객체

예외:

IllegalStateException - 클립보드가 현재 사용할 수 없는 경우

관련 항목:

Toolkit.getSystemClipboard()

getAvailableDataFlavors

public DataFlavor [] getAvailableDataFlavors()

클립보드의 현재의 내용을 제공할 수 있는 DataFlavor 배열을 리턴합니다. 사용 가능한 DataFlavor가 없는 경우는 길이가 제로의 배열을 리턴합니다.

반환값:

클립보드의 현재의 내용을 제공할 수 있는 DataFlavor 배열

예외:

IllegalStateException - 클립보드가 현재 사용할 수 없는 경우

도입된 버전 :

1.5

isDataFlavorAvailable

public boolean isDataFlavorAvailable(DataFlavor  flavor)

클립보드의 현재의 내용이 지정된 DataFlavor로 제공할 수 있을지 어떨지를 리턴합니다.

파라미터:

flavor - 요구된 내용의 DataFlavor

반환값:

클립보드의 현재의 내용이 지정된 DataFlavor로 제공할 수 있는 경우는 true, 그렇지 않은 경우는 false

예외:

NullPointerException - flavor가 null인 경우

IllegalStateException - 클립보드가 현재 사용할 수 없는 경우

도입된 버전 :

1.5

getData

public Object  getData(DataFlavor  flavor)
               throws UnsupportedFlavorException,

                      IOException 

지정된 DataFlavor로 클립보드의 현재의 내용을 나타내는 객체를 리턴합니다. 리턴된 객체의 클래스는 flavor 표현 클래스에서 정의됩니다.

파라미터:

flavor - 요구된 내용의 DataFlavor

반환값:

지정된 DataFlavor로 클립보드의 현재의 내용을 나타내는 객체

예외:

NullPointerException - flavor가 null인 경우

IllegalStateException - 클립보드가 현재 사용할 수 없는 경우

UnsupportedFlavorException - 요구된 DataFlavor를 사용할 수 없는 경우

IOException - 요구된 DataFlavor 데이터를 취득할 수 없는 경우

도입된 버전 :

1.5

관련 항목:

DataFlavor.getRepresentationClass()

addFlavorListener

public void addFlavorListener(FlavorListener  listener)

클립보드로부터 FlavorEvent를 받기 위해서 지정된 FlavorListener를 등록합니다. listener가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

파라미터:

listener - 추가되는 리스너

도입된 버전 :

1.5

관련 항목:

removeFlavorListener(java.awt.datatransfer.FlavorListener), getFlavorListeners(), FlavorListener, FlavorEvent

removeFlavorListener

public void removeFlavorListener(FlavorListener  listener)

이 Clipboard로 부터 FlavorEvent를 받지 않게, 지정된 FlavorListener를 삭제합니다. 인수로서 지정된 리스너가 이전에 이 Clipboard에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. listener가 null인 경우도 같습니다.

파라미터:

listener - 삭제되는 리스너

도입된 버전 :

1.5

관련 항목:

addFlavorListener(java.awt.datatransfer.FlavorListener), getFlavorListeners(), FlavorListener, FlavorEvent

getFlavorListeners

public FlavorListener [] getFlavorListeners()

이 Clipboard에 현재 등록되어 모든 FlavorListener 배열을 리턴합니다.

반환값:

이 클립보드의 모든 FlavorListener, 또는 리스너가 현재 등록되지 않은 경우는 비어있는 배열

도입된 버전 :

1.5

관련 항목:

addFlavorListener(java.awt.datatransfer.FlavorListener), removeFlavorListener(java.awt.datatransfer.FlavorListener), FlavorListener, FlavorEvent