Класс 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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.datatransfer/java/awt/datatransfer/StringSelection.html