Класс DataFormat

java.lang.Object

javafx.scene.input.DataFormat

public class DataFormat
extends Object

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

Since:: JavaFX 2.0

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

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

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

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

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект "равным" этому.
`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, если этот объект равен переданному аргументу; 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.