Класс DataFormat

java.lang.Object

javafx.scene.input.DataFormat

public class DataFormat extends Object

Идентификатор формата данных, используемый для идентификации данных, хранящихся в буфере обмена/dragboard.

Since:: JavaFX 2.0

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final DataFormat`	`FILES`	Представляет список файлов.
`static final DataFormat`	`HTML`	Представляет строку в формате HTML.
`static final DataFormat`	`IMAGE`	Специальный тип изображения, специфичный для платформы, который часто используется в буфере обмена и обеспечивает широкую совместимость с другими приложениями.
`static final DataFormat`	`PLAIN_TEXT`	Представляет строку простого текста.
`static final DataFormat`	`RTF`	Представляет строку в формате RTF.
`static final DataFormat`	`URL`	Представляет URL-адрес, закодированный в виде строки.

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

Конструктор	Описание
`DataFormat(String... ids)`	Создаёт новый DataFormat, задавая набор идентификаторов, связанных с этим форматом данных.

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект "равным" данному объекту.
`final Set<String>`	`getIdentifiers()`	Возвращает неизменяемый набор идентификаторов для этого DataFormat.
`int`	`hashCode()`	Возвращает код хэша для этого объекта `DataFormat`.
`static DataFormat`	`lookupMimeType(String mimeType)`	Ищет DataFormat, который был ранее создан с заданным типом MIME в качестве одного из его идентификаторов.
`String`	`toString()`	Возвращает строковое представление этого объекта `DataFormat`.

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание полей

PLAIN_TEXT

public static final DataFormat PLAIN_TEXT

Представляет строку простого текста.

HTML

public static final DataFormat HTML

Представляет строку в формате HTML.

RTF

public static final DataFormat RTF

Представляет строку в формате RTF.

URL

public static final DataFormat URL

Представляет URL-адрес, закодированный в виде строки.

IMAGE

public static final DataFormat IMAGE

Специальный тип изображения, специфичный для платформы, который часто используется в буфере обмена и обеспечивает широкую совместимость с другими приложениями. Например, на Mac это может быть TIFF, а на Windows — DIB (универсальное растровое изображение).

FILES

public static final DataFormat FILES

Представляет список файлов.

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

DataFormat

public DataFormat(String... ids)

Создаёт новый DataFormat, задавая набор идентификаторов, связанных с этим форматом данных. Обычно идентификаторы представляют собой один или несколько типов MIME. Для каждого идентификатора любые данные, связанные с этим DataFormat, будут зарегистрированы в буфере обмена. Например, предположим, что у нас есть следующее:


     DataFormat fmt = new DataFormat("text/foo", "text/bar");
     Clipboard clipboard = Clipboard.getSystemClipboard();
     ClipboardContent content = new ClipboardContent();
     content.put(fmt, "Hello");
     clipboard.setContent(content);

В соответствии с этим кодом, если мы обратимся к буферу обмена, мы найдём строку "Hello", указанную как для "text/foo", так и для "text/bar" в буфере обмена.

Обратите внимание, что идентификаторы могут быть ограничены платформой в некоторых случаях. Например, Swing требует тип MIME, поэтому если id не имеет формат "тип/подтип", то перетаскивание данных этого типа из/в JFXPanel будет недоступно.

Parameters:: ids - Набор идентификаторов, используемых для представления этого DataFormat в буфере обмена.
Throws:: IllegalArgumentException - если один из указанных типов MIME уже назначен другому DataFormat.

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

getIdentifiers

public final Set<String> getIdentifiers()

Возвращает неизменяемый набор идентификаторов для этого DataFormat.

Returns:: неизменяемый набор, который никогда не равен null.

toString

public String toString()

Возвращает строковое представление этого объекта DataFormat.

Overrides:: toString в классе Object
Returns:: строковое представление этого объекта DataFormat.

hashCode

public int hashCode()

Возвращает код хэша для этого объекта DataFormat.

Overrides:: hashCode в классе Object
Returns:: код хэша для этого объекта DataFormat.

equals

public boolean equals(Object obj)

Указывает, является ли другой объект "равным" данному объекту.

Overrides:: equals в классе Object
Parameters:: obj - ссылка на объект для сравнения.
Returns:: true, если этот объект равен переданному obj аргументу; false в противном случае.

lookupMimeType

public static DataFormat lookupMimeType(String mimeType)

Ищет DataFormat, который был ранее создан с заданным типом MIME в качестве одного из его идентификаторов.

Parameters:: mimeType - Если null или пустая строка, то возвращается null.
Returns:: Соответствующий DataFormat

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.