java.awt.datatransfer

Буфер обмена класса

java.lang. Объект

java.awt.datatransfer. Буфер обмена

public class Clipboard
extends Object

Класс, который реализует механизм, чтобы передать данные, используя сокращение/копию/операции вставки.

FlavorListeners может быть зарегистрирован на экземпляре класса Буфера обмена, который будет уведомлен об изменениях набору DataFlavors доступный на этом буфере обмена (см. addFlavorListener(java.awt.datatransfer.FlavorListener)).

См. Также:

Toolkit.getSystemClipboard(), Toolkit.getSystemSelection()

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected Transferable	содержание
protected ClipboardOwner	владелец

Сводка конструктора

Конструкторы

Конструктор и Описание
Clipboard(String name) Создает объект буфера обмена.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addFlavorListener(FlavorListener listener) Регистрирует указанное FlavorListener получить FlavorEvents от этого буфера обмена.
DataFlavor[]	getAvailableDataFlavors() Возвращает массив DataFlavors, в котором может быть обеспечено текущее содержание этого буфера обмена.
Передаваемый	getContents(Object requestor) Возвращает передаваемый объект, представляющий текущее содержание буфера обмена.
Объект	getData(DataFlavor flavor) Возвращает объект, представляющий текущее содержание этого буфера обмена в указанном DataFlavor.
FlavorListener[]	getFlavorListeners() Возвращает массив весь FlavorListeners в настоящий момент зарегистрированный на этом Clipboard.
Строка	getName() Возвращает имя этого объекта буфера обмена.
boolean	isDataFlavorAvailable(DataFlavor flavor) Возвраты, может ли текущее содержание этого буфера обмена быть обеспечено в указанном DataFlavor.
void	removeFlavorListener(FlavorListener listener) Удаляет указанное FlavorListener так, чтобы это больше не получило FlavorEvents от этого Clipboard.
void	setContents(Transferable contents, ClipboardOwner owner) Устанавливает текущее содержание буфера обмена к указанному передаваемому объекту и регистрирует указанного владельца буфера обмена как владельца нового содержания.

Методы java.lang унаследованный от класса. Объект

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

Полевая Деталь

владелец

protected ClipboardOwner owner

содержание

protected Transferable contents

Деталь конструктора

Буфер обмена

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() непосредственно от этого метода. Например, lostOwnership() может быть вызван позже различный поток. То же самое применяется к FlavorListeners зарегистрированный на этом буфере обмена.

Броски метода IllegalStateException если буфер обмена в настоящий момент недоступен. Например, на некоторых платформах, системный буфер обмена недоступен, в то время как к нему получает доступ другое приложение.

Параметры:

contents - передаваемый объект, представляющий контент буфера обмена

owner - объект, которому принадлежит контент буфера обмена

Броски:

IllegalStateException - если буфер обмена в настоящий момент недоступен

См. Также:

Toolkit.getSystemClipboard()

getContents

public Transferable getContents(Object requestor)

Возвращает передаваемый объект, представляющий текущее содержание буфера обмена. Если у буфера обмена в настоящий момент нет никакого содержания, он возвращается null. Проситель Объекта параметра в настоящий момент не используется. Броски метода IllegalStateException если буфер обмена в настоящий момент недоступен. Например, на некоторых платформах, системный буфер обмена недоступен, в то время как к нему получает доступ другое приложение.

Параметры:

requestor - объект, запрашивающий данные клипа (не используемый)

Возвраты:

текущий передаваемый объект на буфере обмена

Броски:

IllegalStateException - если буфер обмена в настоящий момент недоступен

См. Также:

Toolkit.getSystemClipboard()

getAvailableDataFlavors

public DataFlavor[] getAvailableDataFlavors()

Возвращает массив DataFlavors, в котором может быть обеспечено текущее содержание этого буфера обмена. Если есть нет DataFlavors доступный, этот метод возвращает массив нулевой длиной.

Возвраты:

массив DataFlavors, в котором может быть обеспечено текущее содержание этого буфера обмена

Броски:

IllegalStateException - если этот буфер обмена в настоящий момент недоступен

С тех пор:

1.5

isDataFlavorAvailable

public boolean isDataFlavorAvailable(DataFlavor flavor)

Возвраты, может ли текущее содержание этого буфера обмена быть обеспечено в указанном DataFlavor.

Параметры:

flavor - требуемый DataFlavor для содержания

Возвраты:

true если текущее содержание этого буфера обмена может быть обеспечено в указанном DataFlavor; 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)

Регистрирует указанное FlavorListener получить FlavorEvents от этого буфера обмена. Если listener null, никакое исключение не выдается, и никакое действие не выполняется.

Параметры:

listener - слушатель, который будет добавлен

С тех пор:

1.5

См. Также:

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

removeFlavorListener

public void removeFlavorListener(FlavorListener listener)

Удаляет указанное FlavorListener так, чтобы это больше не получило FlavorEvents от этого Clipboard. Этот метод не выполняет функции, и при этом он не выдает исключение, если слушатель, определенный параметром, не был ранее добавлен к этому Clipboard. Если listener null, никакое исключение не выдается, и никакое действие не выполняется.

Параметры:

listener - слушатель, который будет удален

С тех пор:

1.5

См. Также:

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

getFlavorListeners

public FlavorListener[] getFlavorListeners()

Возвращает массив весь FlavorListeners в настоящий момент зарегистрированный на этом Clipboard.

Возвраты:

весь этот буфер обмена FlavorListeners или пустой массив, если никакие слушатели в настоящий момент не регистрируются

С тех пор:

1.5

См. Также:

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