Класс Font
public final class Font extends Object
Класс Font представляет шрифты, используемые для отображения текста на экране.
Размер Font задаётся в пунктах, представляющих реальную меру, приблизительно равную 1/72 дюйма.
Поскольку шрифты масштабируются вместе с преобразованием рендеринга, определяемым атрибутами преобразования Node, используя Font и его предков, размер будет фактически относиться к локальному координатному пространству узла, что должно обеспечить координаты, похожие на размер пункта, если в среде узла отсутствуют преобразования масштабирования. Обратите внимание, что реальные расстояния, задаваемые стандартной системой координат, лишь приблизительно соответствуют размерам пунктов как правило, и обычно по умолчанию устанавливаются в пиксели экрана для большинства дисплеев.
Дополнительную информацию см. в Node для получения дополнительных сведений о стандартной системе координат.
- С момента:
- JavaFX 2.0
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
Font |
Создаёт шрифт с использованием стандартного начертания "System". |
Font |
Создаёт шрифт с использованием указанного полного имени начертания и размера. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
equals |
Указывает, является ли другой объект "равным" этому объекту. |
static Font |
font |
Ищет подходящий шрифт на основе стандартного семейства шрифтов и заданного размера шрифта. |
static Font |
font |
Ищет подходящий шрифт на основе заданного имени семейства шрифтов и стандартного размера шрифта. |
static Font |
font |
Ищет подходящий шрифт на основе имени семейства шрифтов и размера. |
static Font |
font |
Ищет подходящий шрифт на основе имени семейства шрифтов и стиля наклона. |
static Font |
font |
Ищет подходящий шрифт на основе имени семейства шрифтов и стиля жирности. |
static Font |
font |
Ищет подходящий шрифт на основе имени семейства шрифтов и стилей жирности и наклона. |
static Font |
getDefault() |
Получает стандартный шрифт, который будет из семейства "System", обычно со стилем "Regular" и размером, соответствующим пользовательской рабочей среде, насколько это возможно определить. |
static List<String> |
getFamilies() |
Получает все семейства шрифтов, установленные на системе пользователя, включая шрифты приложений и SDK. |
final String |
getFamily() |
Возвращает семейство этого шрифта. |
static List<String> |
getFontNames() |
Получает имена всех установленных на системе пользователя шрифтов, включая шрифты приложений и SDK. |
static List<String> |
getFontNames |
Получает имена всех шрифтов в указанном семействе шрифтов, установленных на системе пользователя, включая шрифты приложений и SDK. |
final String |
getName() |
Полное имя шрифта. |
final double |
getSize() |
Размер шрифта в пунктах. |
final String |
getStyle() |
Строка, определяющая стиль внутри семейства шрифтов. |
int |
hashCode() |
Возвращает код хеширования для этого объекта Font. |
static Font |
loadFont |
Загружает ресурс шрифта из указанного потока ввода. |
static Font |
loadFont |
Загружает ресурс шрифта с указанного URL. |
static Font[] |
loadFonts |
Загружает ресурсы шрифтов из указанного потока ввода. |
static Font[] |
loadFonts |
Загружает ресурсы шрифтов с указанного URL. |
String |
toString() |
Преобразует этот объект Font в представление String. |
Детали конструкторов
Шрифт
public Font(double size)
- Параметры:
-
size- размер шрифта для использования
Шрифт
public Font(String name, double size)
- Параметры:
-
name- полное имя шрифта. -
size- размер шрифта для использования
Детали методов
getDefault
public static Font getDefault()
- Возвращает:
- Шрифт по умолчанию.
getFamilies
public static List<String> getFamilies()
- Возвращает:
- Список, содержащий все доступные семейства шрифтов.
getFontNames
public static List<String> getFontNames()
- Возвращает:
- Список, содержащий все доступные шрифты.
getFontNames
public static List<String> getFontNames(String family)
- Параметры:
-
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)
- Параметры:
-
family- Семейство шрифта -
weight- Начертание шрифта -
size- Размер шрифта в пунктах. Может быть дробным значением, но не может быть отрицательным. Если размер меньше 0, используется размер по умолчанию. - Возвращает:
- Шрифт, который лучше всего соответствует заданным требованиям.
font
public static Font font(String family, FontPosture posture, double size)
- Параметры:
-
family- Семейство шрифта -
posture- Наклон шрифта -
size- Размер шрифта в пунктах. Может быть дробным значением, но не может быть отрицательным. Если размер меньше 0, используется размер по умолчанию. - Возвращает:
- Шрифт, который лучше всего соответствует заданным требованиям.
font
public static Font font(String family, double size)
- Параметры:
-
family- Семейство шрифта -
size- Размер шрифта в пунктах. Может быть дробным значением, но не может быть отрицательным. Если размер меньше 0, используется размер по умолчанию. - Возвращает:
- Шрифт, который лучше всего соответствует заданным требованиям.
font
public static Font font(String family)
- Параметры:
-
family- Семейство шрифта - Возвращает:
- Шрифт, который лучше всего соответствует заданным требованиям.
font
public static Font font(double size)
- Параметры:
-
size- Размер шрифта в пунктах. Может быть дробным значением, но не может быть отрицательным. Если размер меньше 0, используется размер по умолчанию. - Возвращает:
- Шрифт, который лучше всего соответствует заданным требованиям.
getName
public final String getName()
Существует единый способ загрузки всех шрифтов, предоставляемых приложением (через 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)
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)
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.