Класс Clipboard

Для доступа к общему буферу обмена системы используйте следующий код:

     Clipboard clipboard = Clipboard.getSystemClipboard();
 

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

Буфер обмена работает по принципу наличия единственного концептуального элемента в буфере обмена в любой момент времени — хотя он может быть помещен в буфер обмена в разных форматах. Например, пользователь может выбрать текст в редакторе HTML и нажать ctrl+c или cmd+c для копирования. В этом случае тот же текст может быть доступен в буфере обмена как в формате HTML, так и в формате простого текста. Существует две копии данных в буфере обмена, но обе они представляют одни и те же данные.

Содержание в буфере обмена задаётся с помощью метода setContent(java.util.Map<javafx.scene.input.DataFormat, java.lang.Object>). Сначала создайте объект ClipboardContent, а затем вызовите setContent. Каждый раз, когда вызывается setContent, любые предыдущие данные в буфере обмена очищаются и заменяются этими новыми данными.

     final Clipboard clipboard = Clipboard.getSystemClipboard();
     final ClipboardContent content = new ClipboardContent();
     content.putString("Some text");
     content.putHtml("<b>Some</b> text");
     clipboard.setContent(content);
 

Класс ClipboardContent представляет собой просто карту с удобными методами для работы с распространёнными типами данных, добавленными в буфер обмена.

Поскольку в буфере обмена могут существовать несколько представлений одних и тех же данных, а разные приложения имеют разные возможности обработки разных типов содержимого, важно помещать в буфер обмена как можно больше представлений данных для облегчения работы внешних приложений. Обратите внимание, что иногда операционная система может оказаться полезной в некоторых случаях и добавить несколько типов за вас. Например, Mac может установить строку простого текста для вас, когда вы указываете тип RTF. Как и в каких обстоятельствах это происходит, выходит за рамки этого описания, обратитесь к документации вашей ОС.

При чтении данных из буфера обмена важно сначала искать наиболее богатый поддерживаемый тип. Например, если у меня есть текстовый документ, который поддерживает встраивание изображений и медиаформатов, при вставке содержимого из буфера обмена я должен сначала проверить, может ли содержимое быть представлено как медиа или как изображение. Если нет, тогда я могу проверить RTF или HTML или любой другой богатый текстовый формат, поддерживаемый типом моего документа. Если нет, то я просто могу взять строку.

Или, например, если у меня есть текстовый документ, я просто получу строковое представление и воспользуюсь им, если оно доступно. Я могу проверить, имеет ли буфер обмена "hasHtml" или "hasString".

     if (clipboard.hasString()) { ... }
 

В дополнение к общим или встроенным типам вы можете поместить любые произвольные данные в буфер обмена (предполагая, что они сериализуемы).

Типы содержимого определяются объектами DataFormat. Класс DataFormat определяет неизменяемый объект, и существует ряд статических конечных полей для распространённых типов DataFormat. Конечно, также могут быть объявлены и использованы типы DataFormat, специфичные для приложения. Следующие два метода эквивалентны (и второй вызов перепишет первый!):

     ClipboardContent content = new ClipboardContent();
     content.putString("some text");
     content.put(DataFormat.PLAIN_TEXT, "other text");
 

На встроенных платформах, у которых нет собственной системы окон, буфер обмена, возвращаемый Clipboard.getSystemClipboard(), может быть недоступен извне приложения JavaFX.

Если платформа не поддерживает общий буфер обмена, буфер обмена, возвращаемый Clipboard.getSystemClipboard(), может использоваться для обмена данными между различными частями одного приложения JavaFX, но не может использоваться для обмена данными между несколькими приложениями.