Класс Clipboard

java.lang.Object

java.awt.datatransfer.Clipboard

public class Clipboard extends Object

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

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

Since:

1.1

См. также:

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

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

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

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

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

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

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

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

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

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

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

Параметры:

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

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

Исключения:

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

См. также:

getContents

public Transferable getContents(Object requestor)

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

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

getAvailableDataFlavors

public DataFlavor[] getAvailableDataFlavors()

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

Возвращает:: массив DataFlavor, в котором можно предоставить текущее содержимое этого буфера обмена
Исключения:: IllegalStateException - если этот буфер обмена в настоящее время недоступен
Since:: 1.5

isDataFlavorAvailable

public boolean isDataFlavorAvailable(DataFlavor flavor)

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

Параметры:: flavor - запрашиваемый DataFlavor для содержимого
Возвращает:: true, если текущее содержимое этого буфера обмена можно предоставить в указанном DataFlavor; false в противном случае
Исключения:: NullPointerException - если flavor является null; IllegalStateException - если этот буфер обмена в настоящее время недоступен
Since:: 1.5

getData

public Object getData(DataFlavor flavor) throws UnsupportedFlavorException, IOException

Возвращает объект, представляющий текущее содержимое этого буфера обмена в указанном DataFlavor. Класс возвращаемого объекта определяется классом представления flavor.

Параметры:

flavor - запрашиваемый DataFlavor для содержимого

Возвращает:

объект, представляющий текущее содержимое этого буфера обмена в указанном DataFlavor

Исключения:

NullPointerException - если flavor является null

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

UnsupportedFlavorException - если запрашиваемый DataFlavor недоступен

IOException - если данные в запрошенном DataFlavor не могут быть извлечены

Since:

1.5

См. также:

addFlavorListener

public void addFlavorListener(FlavorListener listener)

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

Параметры:

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

Since:

1.5

См. также:

removeFlavorListener

public void removeFlavorListener(FlavorListener listener)

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

Параметры:

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

Since:

1.5

См. также:

getFlavorListeners

public FlavorListener[] getFlavorListeners()

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

Возвращает:

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

Since:

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.datatransfer/java/awt/datatransfer/Clipboard.html