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

• getDefault

  public static Font getDefault()

  Возвращает стандартный шрифт, который будет из семейства "Система", обычно со стилем "Обычный" и размером, соответствующим пользовательской операционной системе, в той мере, в какой это можно определить.

  Возвращает:

  Стандартный шрифт.

• getFamilies

  public static List<String> getFamilies()

  Возвращает все установленные на системе пользователя семейства шрифтов, включая шрифты приложений и SDK. Этот вызов имеет соображения по производительности, так как поиск всех шрифтов может быть дорогостоящей операцией при первом обращении.

  Возвращает:

  Список, содержащий все доступные семейства шрифтов.

• getFontNames

  public static List<String> getFontNames()

  Возвращает имена всех установленных на системе пользователя шрифтов, включая шрифты приложений и SDK. Этот вызов имеет соображения по производительности, так как поиск всех шрифтов может быть дорогостоящей операцией при первом обращении.

  Возвращает:

  Список, содержащий все доступные шрифты.

• getFontNames

  public static List<String> getFontNames​(String family)

  Возвращает имена всех шрифтов в указанном семействе шрифтов, установленных на системе пользователя, включая шрифты приложений и SDK. Этот вызов имеет соображения по производительности, так как поиск всех шрифтов может быть дорогостоящей операцией при первом обращении.

  Параметры:

  family - семейство шрифтов

  Возвращает:

  Список, содержащий шрифты для данного семейства.

• font

  public static Font font​(String family,
                          FontWeight weight,
                          FontPosture posture,
                          double size)

  Ищет подходящий шрифт на основе имени семейства, стиля и начертания. Этот метод не гарантирует возврата конкретного шрифта, но делает всё возможное, чтобы найти шрифт, соответствующий указанным требованиям.

  Значение null или пустая строка для семейства позволяет реализации выбрать любой подходящий шрифт.

  Параметры:

  family - Семейство шрифта

  weight - Начертание шрифта

  posture - Начертание или наклон шрифта

  size - Размер шрифта в пунктах. Может быть дробным значением, но не может быть отрицательным. Если размер < 0, будет использован стандартный размер.

  Возвращает:

  Шрифт, наиболее подходящий к заданным требованиям.

• font

  public static Font font​(String family,
                          FontWeight weight,
                          double size)

  Ищет подходящий шрифт на основе имени семейства и стиля начертания. Этот метод не гарантирует возврата конкретного шрифта, но делает всё возможное, чтобы найти шрифт, соответствующий указанным требованиям. Значение null или пустая строка для семейства позволяет реализации выбрать любой подходящий шрифт.

  Параметры:

  family - Семейство шрифта

  weight - Начертание шрифта

  size - Размер шрифта в пунктах. Может быть дробным значением, но не может быть отрицательным. Если размер < 0, будет использован стандартный размер.

  Возвращает:

  Шрифт, наиболее подходящий к заданным требованиям.

• font

  public static Font font​(String family,
                          FontPosture posture,
                          double size)

  Ищет подходящий шрифт на основе имени семейства и стиля начертания. Этот метод не гарантирует возврата конкретного шрифта, но делает всё возможное, чтобы найти шрифт, соответствующий указанным требованиям. Значение null или пустая строка для семейства позволяет реализации выбрать любой подходящий шрифт.

  Параметры:

  family - Семейство шрифта

  posture - Начертание или наклон шрифта

  size - Размер шрифта в пунктах. Может быть дробным значением, но не может быть отрицательным. Если размер < 0, будет использован стандартный размер.

  Возвращает:

  Шрифт, наиболее подходящий к заданным требованиям.

• font

  public static Font font​(String family,
                          double size)

  Ищет подходящий шрифт на основе имени семейства и размера. Этот метод не гарантирует возврата конкретного шрифта, но делает всё возможное, чтобы найти шрифт, соответствующий указанным требованиям. Значение null или пустая строка для семейства позволяет реализации выбрать любой подходящий шрифт.

  Параметры:

  family - Семейство шрифта

  size - Размер шрифта в пунктах. Может быть дробным значением, но не может быть отрицательным. Если размер < 0, будет использован стандартный размер.

  Возвращает:

  Шрифт, наиболее подходящий к заданным требованиям.

• font

  public static Font font​(String family)

  Ищет подходящий шрифт на основе заданного имени семейства шрифта и стандартного размера. Этот метод не гарантирует возврата конкретного шрифта, но делает всё возможное, чтобы найти шрифт, соответствующий указанным требованиям. Значение null или пустая строка для семейства позволяет реализации выбрать любой подходящий шрифт.

  Параметры:

  family - Семейство шрифта

  Возвращает:

  Шрифт, наиболее подходящий к заданным требованиям.

• font

  public static Font font​(double size)

  Ищет подходящий шрифт на основе стандартного имени семейства шрифта и заданного размера. Этот метод не гарантирует возврата конкретного шрифта, но делает всё возможное, чтобы найти шрифт, соответствующий указанным требованиям.

  Параметры:

  size - Размер шрифта в пунктах. Может быть дробным значением, но не может быть отрицательным. Если размер < 0, будет использован стандартный размер.

  Возвращает:

  Шрифт, наиболее подходящий к заданным требованиям.

• getName

  public final String getName()

  Полное имя шрифта. Это имя включает как имя семейства, так и вариант стиля в рамках этого семейства. Например, для простого шрифта Arial это будет "Arial Regular", а для жирного шрифта Arial это будет "Arial Bold". Точное имя для загрузки шрифта определяется в каждом файле шрифта как полное имя шрифта. Например, "Proxima Nova ExtraCondensed Bold Italic" относится к конкретному шрифту Proxima Nova. Значение null или пустая строка для имени позволяет реализации выбрать любой подходящий шрифт.

  Существует единственный унифицированный способ загрузки всех шрифтов, предоставляемых приложением (через Font.loadFont(), шрифтов JavaFX runtime и установленных системных шрифтов. Просто создайте шрифт, указав полное имя шрифта, который вы хотите загрузить. Если конкретный шрифт не найден, используется резервный или стандартный шрифт. Свойство "name" будет обновлено, чтобы отразить фактическое имя используемого шрифта. Условие сбоя загрузки можно обнаружить, проверив имя шрифта с именем, которое вы пытались загрузить.

  Обратите внимание, что если вы хотите найти шрифт по семейству и стилю, можно использовать один из методов-фабрик font(java.lang.String, javafx.scene.text.FontWeight, javafx.scene.text.FontPosture, double) , определённых в этом классе.

  Значение по умолчанию:

  пустая строка

  Возвращает:

  полное имя шрифта

• getFamily

  public final String getFamily()

  Возвращает семейство этого шрифта.

  Возвращает:

  Семейство этого шрифта.

• getStyle

  public final String getStyle()

  Строковое представление стиля, указанного в семействе шрифтов.

  Возвращает:

  Имя стиля этого шрифта.

• getSize

  public final double getSize()

  Размер шрифта в пунктах. Может быть дробным значением, например, 11.5. Если указанное значение < 0, будет использован стандартный размер.

  Значение по умолчанию:

  12

  Возвращает:

  размер шрифта в пунктах

• loadFont

  public static Font loadFont​(String urlStr,
                              double size)

  Загружает ресурс шрифта из указанного URL. Если загрузка выполнена успешно, местоположение читаемо и это представляет поддерживаемый формат шрифта, то будет возвращён объект Font.

  Если присутствует менеджер безопасности, приложение должно иметь разрешение на чтение из указанного расположения URL и FXPermission "loadFont". Если у приложения нет разрешения на чтение из указанного расположения URL, то возвращается null. Если у приложения нет разрешения "loadFont", то этот метод вернёт системный шрифт по умолчанию с указанным размером шрифта.

  Любой сбой, такой как неверный URL, невозможность найти или прочитать ресурс, или если он не представляет собой шрифт, приведёт к возврату null. Приложение должно проверить это перед использованием.

  При успешном (не-null) возврате шрифт будет зарегистрирован в графической системе FX для создания конструкторами и методами-фабриками, и приложение должно использовать его таким образом, а не вызывать этот метод снова, что повторит издержки загрузки и установки шрифта.

  Параметр шрифта size является удобным способом, чтобы в типичном использовании приложение могло напрямую использовать возвращённый (не-null) шрифт, вместо необходимости создания его через конструктор. Недопустимые размеры — это те, что <=0, и приведут к размеру по умолчанию.

  Если URL представляет собой локальный файл на диске, то копирование не выполняется, и файл шрифта должен сохраняться в течение всего срока жизни приложения. Обновление файла любым способом приведёт к непредсказуемому и, вероятно, нежелательному поведению.

  Параметры:

  urlStr - из которого загрузить шрифт, указанный как строка.

  size - возвращаемого шрифта.

  Возвращает:

  шрифт, или null, если шрифт не может быть создан.

• loadFonts

  public static Font[] loadFonts​(String urlStr,
                                 double size)

  Загружает ресурсы шрифтов из указанного URL. Если загрузка выполнена успешно, местоположение читаемо и это представляет поддерживаемый формат шрифта, то будет возвращён массив Font.

  Случай использования этого метода — для загрузки всех шрифтов из коллекции TrueType (TTC).

  Если присутствует менеджер безопасности, приложение должно иметь разрешение на чтение из указанного расположения URL и FXPermission "loadFont". Если у приложения нет разрешения на чтение из указанного расположения URL, то возвращается null. Если у приложения нет разрешения "loadFont", то этот метод вернёт массив из одного элемента, который представляет собой системный шрифт по умолчанию с указанным размером шрифта.

  Любой сбой, такой как неверный URL, невозможность найти или прочитать ресурс, или если он не представляет собой шрифт, приведёт к возврату null. Приложение должно проверить это перед использованием.

  При успешном (не-null) возврате шрифты будут зарегистрированы в графической системе FX для создания конструкторами и методами-фабриками, и приложение должно использовать их таким образом, а не вызывать этот метод снова, что повторит издержки загрузки и установки шрифтов.

  Параметр шрифта size является удобным способом, чтобы в типичном использовании приложение могло напрямую использовать возвращённый (не-null) шрифт, вместо необходимости создания его через конструктор. Недопустимые размеры — это те, что <=0, и приведут к размеру по умолчанию.

  Если URL представляет собой локальный файл на диске, то копирование не выполняется, и файл шрифта должен сохраняться в течение всего срока жизни приложения. Обновление файла любым способом приведёт к непредсказуемому и, вероятно, нежелательному поведению.

  Параметры:

  urlStr - из которого загрузить шрифты, указанный как строка.

  size - возвращаемых шрифтов.

  Возвращает:

  массив шрифтов, или null, если шрифты не могут быть созданы.

  С момента:

  9

• loadFont

  public static Font loadFont​(InputStream in,
                              double size)

  Загружает ресурс шрифта из указанного потока ввода. Если загрузка выполнена успешно, поток ввода может быть полностью прочитан, и это представляет поддерживаемый формат шрифта, то будет возвращён объект Font.

  Если присутствует менеджер безопасности, приложение должно иметь FXPermission "loadFont". Если у приложения нет разрешения, то этот метод вернёт системный шрифт по умолчанию с указанным размером шрифта.

  Любой сбой, такой как сокращённый ввод, или неподдерживаемый формат шрифта, приведёт к возврату null. Приложение должно проверить это перед использованием.

  При успешном (не-null) возврате шрифт будет зарегистрирован в графической системе FX для создания конструкторами и методами-фабриками, и приложение должно использовать его таким образом, а не вызывать этот метод снова, что повторит издержки повторного чтения и установки шрифта.

  Параметр шрифта size является удобным способом, чтобы в типичном использовании приложение могло напрямую использовать возвращённый (не-null) шрифт, вместо необходимости создания его через конструктор. Недопустимые размеры — это те, что <=0, и приведут к размеру по умолчанию.

  Этот метод не закрывает поток ввода.

  Параметры:

  in - поток ввода, из которого загрузить шрифт.

  size - возвращаемого шрифта.

  Возвращает:

  шрифт, или null, если шрифт не может быть создан.

• loadFonts

  public static Font[] loadFonts​(InputStream in,
                                 double size)

  Загружает ресурсы шрифтов из указанного потока ввода. Если загрузка выполнена успешно, поток ввода может быть полностью прочитан, и это представляет поддерживаемый формат шрифта, то будет возвращён массив Font.

  Случай использования этого метода — для загрузки всех шрифтов из коллекции TrueType (TTC).

  Если присутствует менеджер безопасности, приложение должно иметь FXPermission "loadFont". Если у приложения нет разрешения, то этот метод вернёт системный шрифт по умолчанию с указанным размером шрифта.

  Любой сбой, такой как сокращённый ввод, или неподдерживаемый формат шрифта, приведёт к возврату null. Приложение должно проверить это перед использованием.

  При успешном (не-null) возврате шрифты будут зарегистрированы в графической системе FX для создания конструкторами и методами-фабриками, и приложение должно использовать их таким образом, а не вызывать этот метод снова, что повторит издержки повторного чтения и установки шрифтов.

  Параметр шрифта size является удобным способом, чтобы в типичном использовании приложение могло напрямую использовать возвращённые (не-null) шрифты, вместо необходимости повторного создания через конструктор. Недопустимые размеры — это те, что <=0, и приведут к размеру по умолчанию.

  Этот метод не закрывает поток ввода.

  Параметры:

  in - поток ввода, из которого загрузить шрифты.

  size - возвращаемых шрифтов.

  Возвращает:

  массив шрифтов, или null, если шрифты не могут быть созданы.

  С момента:

  9

• toString

  public String toString()

  Преобразует этот объект Font в представление String. Строковое представление предназначено только для информационных целей и будет изменяться. Не используйте это строковое представление для каких-либо программных целей.

  Переопределяет:

  toString в классе Object

• equals

  public boolean equals​(Object obj)

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

  Переопределяет:

  equals в классе Object

  Параметры:

  obj - объект-ссылка для сравнения.

  Возвращает:

  true, если этот объект равен аргументу obj; false в противном случае.

• hashCode

  public int hashCode()

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

  Переопределяет:

  hashCode в классе Object

  Возвращает:

  хэш-код для этого объекта Font.