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

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

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