java.awt.datatransfer
클래스 Clipboard

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

public class Clipboard
extends Object 

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

Clipboard 클래스의 인스턴스에 FlavorListener 를 등록하면(자), 이 클립보드로 사용 가능한 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 를 throw 합니다. 예를 들어, 플랫폼에 따라서는, 다른 어플리케이션이 액세스 하고 있는 동안은 시스템 클립보드를 이용할 수 없는 경우가 있습니다.

파라미터:

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 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 행해지지 않습니다.

파라미터:

listener - 추가되는 청취자

도입된 버젼:

1.5

관련 항목:

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

removeFlavorListener

public void removeFlavorListener(FlavorListener  listener)

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

파라미터:

listener - 삭제되는 청취자

도입된 버젼:

1.5

관련 항목:

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

getFlavorListeners

public FlavorListener [] getFlavorListeners()

이 Clipboard 에 현재 등록되어 모든 FlavorListener 의 배열을 돌려줍니다.

반환값:

이 클립보드의 모든 FlavorListener. 청취자가 현재 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

1.5

관련 항목:

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