Класс StringSelection

java.lang.Object

java.awt.datatransfer.StringSelection

Все реализуемые интерфейсы:: ClipboardOwner, Transferable

public class StringSelection extends Object implements Transferable, ClipboardOwner

Transferable, реализующий возможность, необходимую для передачи String.

Этот Transferable корректно поддерживает DataFlavor.stringFlavor и все эквивалентные варианты. Поддержка DataFlavor.plainTextFlavor и всех эквивалентных вариантов устарела. Другие DataFlavor не поддерживаются.

Начиная с:

1.1

См. также:

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

Конструктор	Описание
`StringSelection(String data)`	Создает `Transferable`, способный передавать указанный `String`.

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

Модификатор и тип	Метод	Описание
`Object`	`getTransferData(DataFlavor flavor)`	Возвращает данные `Transferable` в запрошенном `DataFlavor`, если это возможно.
`DataFlavor[]`	`getTransferDataFlavors()`	Возвращает массив вариантов, в которых этот `Transferable` может предоставлять данные.
`boolean`	`isDataFlavorSupported(DataFlavor flavor)`	Возвращает, поддерживается ли запрошенный вариант этим `Transferable`.
`void`	`lostOwnership(Clipboard clipboard, Transferable contents)`	Уведомляет этот объект о том, что он больше не является владельцем буфера обмена.

Методы, объявленные в классе 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()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо истечения заданного промежутка реального времени.

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

StringSelection

public StringSelection(String data)

Создает Transferable, способный передавать указанный String.

Параметры:: data — строка для передачи

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

getTransferDataFlavors

public DataFlavor[] getTransferDataFlavors()

Возвращает массив вариантов, в которых этот Transferable может предоставлять данные. DataFlavor.stringFlavor поддерживается корректно. Поддержка DataFlavor.plainTextFlavor устарела.

Определен в:: getTransferDataFlavors в интерфейсе Transferable
Возвращает:: массив длины два, элементами которого являются DataFlavor.stringFlavor и DataFlavor.plainTextFlavor

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor flavor)

Возвращает, поддерживается ли запрошенный вариант этим Transferable.

Определен в:: isDataFlavorSupported в интерфейсе Transferable
Параметры:: flavor — запрошенный вариант данных
Возвращает:: true, если flavor равен DataFlavor.stringFlavor или DataFlavor.plainTextFlavor; false, если flavor не является одним из перечисленных выше вариантов
Выбрасывает:: NullPointerException — если flavor равен null

getTransferData

public Object getTransferData(DataFlavor flavor) throws UnsupportedFlavorException, IOException

Возвращает данные Transferable в запрошенном DataFlavor, если это возможно. Если запрошенный вариант — DataFlavor.stringFlavor или эквивалентный ему вариант, возвращается String, представляющий выбранные данные. Если запрошенный вариант — DataFlavor.plainTextFlavor или эквивалентный ему вариант, возвращается Reader.
Примечание: Поведение этого метода для DataFlavor.plainTextFlavor и эквивалентных DataFlavor не соответствует определению DataFlavor.plainTextFlavor.

Определен в:

getTransferData в интерфейсе Transferable

Параметры:

flavor — запрошенный вариант данных

Возвращает:

данные в запрошенном варианте, как описано выше

Выбрасывает:

UnsupportedFlavorException — если запрошенный вариант данных не эквивалентен ни DataFlavor.stringFlavor, ни DataFlavor.plainTextFlavor

IOException — если при получении данных возникает IOException. По умолчанию StringSelection никогда не выбрасывает это исключение, однако подкласс может это делать.

NullPointerException — если flavor равен null

См. также:

lostOwnership

public void lostOwnership(Clipboard clipboard, Transferable contents)

Описание скопировано из интерфейса: ClipboardOwner

Уведомляет этот объект о том, что он больше не является владельцем буфера обмена. Этот метод вызывается, когда другое приложение или другой объект в этом приложении получает право владения буфером обмена.

Определен в:: lostOwnership в интерфейсе ClipboardOwner
Параметры:: clipboard — буфер обмена, которым объект больше не владеет; contents — содержимое, помещенное этим владельцем в clipboard

© 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.