Spec-Zone.ru › OpenJavaFX 17

Класс Font

java.lang.Object
javafx.scene.text.Font
public final class Font
extends Object

Класс Font представляет шрифты, которые используются для отображения текста на экране.

Размер Font описывается в пунктах, что является реальной единицей измерения, приблизительно равной 1/72 дюйма.

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

Для получения дополнительной информации см. Node для получения дополнительной информации о стандартной системе координат.

С:
JavaFX 2.0

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

Конструкторы
Конструктор Описание
Font​(double size)
Создает шрифт, используя стандартное название шрифта "System".
Font​(String name, double size)
Создает шрифт, используя указанное полное имя шрифта и размер.

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

Модификатор и тип Метод Описание
boolean equals​(Object obj)
Указывает, является ли другой объект "равным" данному.
static Font font​(double size)
Ищет подходящий шрифт, основываясь на стандартном имени семейства шрифтов и заданном размере шрифта.
static Font font​(String family)
Ищет подходящий шрифт, основываясь на заданном имени семейства шрифтов и стандартном размере шрифта.
static Font font​(String family, double size)
Ищет подходящий шрифт, основываясь на имени семейства шрифтов и размере.
static Font font​(String family, FontPosture posture, double size)
Ищет подходящий шрифт, основываясь на имени семейства шрифтов и стиле наклона.
static Font font​(String family, FontWeight weight, double size)
Ищет подходящий шрифт, основываясь на имени семейства шрифтов и стиле начертания.
static Font font​(String family, FontWeight weight, FontPosture posture, double size)
Ищет подходящий шрифт, основываясь на имени семейства шрифтов и стиле начертания и наклона.
static Font getDefault()
Получает стандартный шрифт, который будет из семейства "System", обычно стиля "Regular" и размера, соответствующего пользовательской среде рабочего стола, в той мере, в которой это можно определить.
static List<String> getFamilies()
Получает все семейства шрифтов, установленные на системе пользователя, включая шрифты приложений и SDK-шрифты.
String getFamily()
Возвращает семейство этого шрифта.
static List<String> getFontNames()
Получает имена всех шрифтов, установленных на системе пользователя, включая шрифты приложений и SDK-шрифты.
static List<String> getFontNames​(String family)
Получает имена всех шрифтов в указанном семействе шрифтов, установленных на системе пользователя, включая шрифты приложений и SDK-шрифты.
String getName()
Полное имя шрифта.
double getSize()
Размер шрифта в пунктах.
String getStyle()
Строка, описывающая стиль шрифта в рамках семейства шрифтов.
int hashCode()
Возвращает хеш-код для этого объекта Font.
static Font loadFont​(InputStream in, double size)
Загружает шрифт из указанного потока.
static Font loadFont​(String urlStr, double size)
Загружает шрифт с указанного URL.
static Font[] loadFonts​(InputStream in, double size)
Загружает несколько шрифтов из указанного потока.
static Font[] loadFonts​(String urlStr, double size)
Загружает несколько шрифтов с указанного URL.
String toString()
Преобразует этот объект Font в строковое представление.

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

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

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

Шрифт

public Font(double size)
Создаёт шрифт с использованием стандартного имени "System". Используемый шрифт определяется реализацией на основе типового шрифта пользовательского интерфейса для текущей среды UI.
Параметры:
size - размер шрифта

Шрифт

public Font(String name, double size)
Создаёт шрифт с использованием указанного полного имени шрифта и размера.
Параметры:
name - полное имя шрифта.
size - размер шрифта

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

getDefault

public static Font getDefault()
Возвращает стандартный шрифт, который, как правило, берётся из семейства "System", стиля "Regular" и размера, соответствующего среде пользователя, насколько это можно определить.
Возвращает:
Стандартный шрифт.

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, и установленных системных шрифтов. Просто создайте шрифт, указав полное имя шрифта, который вы хотите загрузить. Если конкретный шрифт не найден, используется резервный или стандартный шрифт. Имя будет обновлено, чтобы отразить фактическое имя используемого шрифта. Условие неудачи загрузки можно обнаружить, проверив имя шрифта с именем, которое вы пытались загрузить.

Обратите внимание, что если вы хотите найти шрифт по семейству и стилю, вы можете использовать один из 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 представляет локальный файл на диске, то копирование не выполняется, и файл шрифта должен сохраняться на протяжении всего срока действия приложения. Обновление файла любым способом приведёт к неопределённому и, вероятно, нежелательному поведению.

Parameters:
urlStr - из которого загрузить шрифт, указанный как строка.
size - возвращаемого шрифта.
Returns:
шрифт, или 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 представляет локальный файл на диске, то копирование не выполняется, и файл шрифта должен сохраняться на протяжении всего срока действия приложения. Обновление файла любым способом приведёт к неопределённому и, вероятно, нежелательному поведению.

Parameters:
urlStr - из которого загрузить шрифты, указанный как строка.
size - возвращаемых шрифтов.
Returns:
массив шрифтов, или null, если шрифты не могут быть созданы.
Since:
9

loadFont

public static Font loadFont(InputStream in, double size)
Загружает ресурс шрифта из указанного потока ввода. Если загрузка выполнена успешно, поток может быть полностью прочитан, и он представляет поддерживаемый формат шрифта, то будет возвращён объект Font.

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

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

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

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

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

Parameters:
in - поток ввода для загрузки шрифта.
size - возвращаемого шрифта.
Returns:
шрифт, или null, если шрифт не может быть создан.

loadFonts

public static Font[] loadFonts(InputStream in, double size)
Загружает ресурсы шрифтов из указанного потока ввода. Если загрузка выполнена успешно, поток может быть полностью прочитан, и он представляет поддерживаемый формат шрифта, то будет возвращён массив Font.

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

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

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

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

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

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

Parameters:
in - поток ввода для загрузки шрифтов.
size - возвращаемых шрифтов.
Returns:
массив шрифтов, или null, если шрифты не могут быть созданы.
Since:
9

toString

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

equals

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

hashCode

public int hashCode()
Возвращает код хэширования для этого объекта Font.
Overrides:
hashCode в классе Object
Returns:
код хэширования для этого объекта Font.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API