Класс Clipboard

java.lang.Object

java.awt.datatransfer.Clipboard

public class Clipboard extends Object

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

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

Начиная с:

1.1

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected Transferable`	`contents`	Содержимое буфера обмена.
`protected ClipboardOwner`	`owner`	Владелец буфера обмена.

Краткое описание конструкторов

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

Краткое описание методов

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

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданный промежуток реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданный промежуток реального времени.

Подробное описание полей

owner

protected ClipboardOwner owner

Владелец буфера обмена.

protected Transferable contents

Содержимое буфера обмена.

Подробное описание конструкторов

Clipboard

public Clipboard(String name)

Создает объект буфера обмена.

Параметры:

name — для буфера обмена

См. также:

Подробное описание методов

getName

public String getName()

Возвращает имя этого объекта буфера обмена.

Возвращает:

имя этого объекта буфера обмена

См. также:

setContents

public void setContents(Transferable contents, ClipboardOwner owner)

Устанавливает указанный объект transferable в качестве текущего содержимого буфера обмена и регистрирует указанного владельца буфера обмена как владельца нового содержимого.

Если существует владелец, отличный от аргумента owner, ему сообщается о потере владения содержимым буфера обмена путем вызова ClipboardOwner.lostOwnership() для этого владельца. Реализация setContents() может не вызывать lostOwnership() непосредственно из этого метода. Например, lostOwnership() может быть вызван позднее в другом потоке. То же относится к FlavorListeners, зарегистрированным в этом буфере обмена.

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

Параметры:

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

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

Исключения:

IllegalStateException — если буфер обмена в данный момент недоступен

См. также:

getContents

public Transferable getContents(Object requestor)

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

Параметры:

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

Возвращает:

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

Исключения:

IllegalStateException — если буфер обмена в данный момент недоступен

См. также:

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

См. также:

addFlavorListener

public void addFlavorListener(FlavorListener listener)

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

Параметры:

listener — добавляемый слушатель

Начиная с:

1.5

См. также:

removeFlavorListener

public void removeFlavorListener(FlavorListener listener)

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

Параметры:

listener — удаляемый слушатель

Начиная с:

1.5

См. также:

getFlavorListeners

public FlavorListener[] getFlavorListeners()

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

Возвращает:

все FlavorListeners этого буфера обмена или пустой массив, если в данный момент нет зарегистрированных слушателей

Начиная с:

1.5

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.