Класс 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 представляет собой просто карту с удобными методами для работы с распространенными типами данных, добавляемыми в буфер обмена.

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

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

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

     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.

Если присутствует менеджер безопасности, приложение должно иметь разрешение FXPermission "accessClipboard", чтобы буфер обмена, возвращаемый Clipboard.getSystemClipboard(), был доступен извне приложения JavaFX. Для совместимости с предыдущими версиями JDK эквивалентное AWTPermission разрешение "accessClipboard" также позволит получить доступ к буферу обмена FX извне приложения JavaFX.

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