Класс StringSelection

java.lang.Object

java.awt.datatransfer.StringSelection

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

public class StringSelection extends Object implements Transferable, ClipboardOwner

Класс, реализующий функциональность передачи строки.

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

С момента:

1.1

См. также:

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

Конструктор	Описание
`StringSelection(String data)`	Создаёт объект для передачи указанной строки.

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

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

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

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

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

StringSelection

public StringSelection(String data)

Создаёт объект для передачи указанной строки.

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

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

getTransferDataFlavors

public DataFlavor[] getTransferDataFlavors()

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

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

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor flavor)

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

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

getTransferData

public Object getTransferData(DataFlavor flavor) throws UnsupportedFlavorException, IOException

Возвращает данные объекта в указанном формате, если это возможно. Если требуемый формат — DataFlavor.stringFlavor или эквивалентный формат, возвращается String, представляющий выделенный текст. Если требуемый формат — DataFlavor.plainTextFlavor или эквивалентный формат, возвращается строка.
Примечание: Поведение этого метода для форматов DataFlavor.plainTextFlavor и эквивалентных форматов не соответствует определению 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 - содержимое, которое этот владелец поместил в буфер обмена

© 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/StringSelection.html