Класс 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 |
getFamilies() |
Возвращает все семейства шрифтов, установленные на системе пользователя, включая шрифты приложений и SDK. |
final String |
getFamily() |
Возвращает семейство шрифтов. |
static List |
getFontNames() |
Возвращает имена всех установленных шрифтов на системе пользователя, включая шрифты приложений и SDK. |
static List |
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, невозможность найти или прочитать ресурс, или если он не представляет собой шрифт, приведёт к возвращению null. Приложение должно проверить это перед использованием.
При успешном (не-нулевом) возврате шрифт будет зарегистрирован в системе графики FX для создания с помощью доступных конструкторов и методов-фабрик, и приложение должно использовать его таким образом, а не вызывать этот метод снова, что повторит затраты на загрузку и установку шрифта.
Параметр шрифта size — это удобство, позволяющее при типичном использовании приложению напрямую использовать возвращённый (не-нулевой) шрифт, а не создавать его через конструктор. Некорректные размеры — это те, которые <=0, и они приведут к использованию размера по умолчанию.
Если URL представляет собой локальный файл на диске, то копирование не выполняется, и файл шрифта должен сохраняться на протяжении всего жизненного цикла приложения. Обновление файла каким-либо образом приведёт к непредсказуемому и, вероятно, нежелательному поведению.
- Parameters:
-
urlStr- из которого загрузить шрифт, заданный как строка. -
size- возвращённого шрифта. - Returns:
- шрифт, или null, если шрифт не может быть создан.
loadFonts
public static Font[] loadFonts(String urlStr, double size)
Font. Сценарий использования этого метода — загрузка всех шрифтов из коллекции TrueType (TTC).
Любая ошибка, такая как некорректный URL, невозможность найти или прочитать ресурс, или если он не представляет собой шрифт, приведёт к возвращению null. Приложение должно проверить это перед использованием.
При успешном (не-нулевом) возврате шрифты будут зарегистрированы в системе графики FX для создания с помощью доступных конструкторов и методов-фабрик, и приложение должно использовать их таким образом, а не вызывать этот метод снова, что повторит затраты на загрузку и установку шрифтов.
Параметр шрифта size — это удобство, позволяющее при типичном использовании приложению напрямую использовать возвращённый (не-нулевой) шрифт, а не создавать его через конструктор. Некорректные размеры — это те, которые <=0, и они приведут к использованию размера по умолчанию.
Если URL представляет собой локальный файл на диске, то копирование не выполняется, и файл шрифта должен сохраняться на протяжении всего жизненного цикла приложения. Обновление файла каким-либо образом приведёт к непредсказуемому и, вероятно, нежелательному поведению.
- Parameters:
-
urlStr- из которого загрузить шрифты, заданный как строка. -
size- возвращённых шрифтов. - Returns:
- массив шрифтов, или null, если шрифты не могут быть созданы.
- Since:
- 9
loadFont
public static Font loadFont(InputStream in, double size)
Font. Любая ошибка, такая как сокращённый ввод или неподдерживаемый формат шрифта, приведёт к возвращению null. Приложение должно проверить это перед использованием.
При успешном (не-нулевом) возврате шрифт будет зарегистрирован в системе графики FX для создания с помощью доступных конструкторов и методов-фабрик, и приложение должно использовать его таким образом, а не вызывать этот метод снова, что повторит затраты на повторное чтение и установку шрифта.
Параметр шрифта size — это удобство, позволяющее при типичном использовании приложению напрямую использовать возвращённый (не-нулевой) шрифт, а не создавать его через конструктор. Некорректные размеры — это те, которые <=0, и они приведут к использованию размера по умолчанию.
Этот метод не закрывает поток ввода.
- Parameters:
-
in- поток ввода для загрузки шрифта. -
size- возвращённого шрифта. - Returns:
- шрифт, или null, если шрифт не может быть создан.
loadFonts
public static Font[] loadFonts(InputStream in, double size)
Font. Сценарий использования этого метода — загрузка всех шрифтов из коллекции TrueType (TTC).
Любая ошибка, такая как сокращённый ввод или неподдерживаемый формат шрифта, приведёт к возвращению null. Приложение должно проверить это перед использованием.
При успешном (не-нулевом) возврате шрифты будут зарегистрированы в системе графики FX для создания с помощью доступных конструкторов и методов-фабрик, и приложение должно использовать их таким образом, а не вызывать этот метод снова, что повторит затраты на повторное чтение и установку шрифтов.
Параметр шрифта size — это удобство, позволяющее при типичном использовании приложению напрямую использовать возвращённые (не-нулевые) шрифты, а не пересоздавать их через конструктор. Некорректные размеры — это те, которые <=0, и они приведут к использованию размера по умолчанию.
Этот метод не закрывает поток ввода.
- Parameters:
-
in- поток ввода для загрузки шрифтов. -
size- возвращённых шрифтов. - Returns:
- массив шрифтов, или null, если шрифты не могут быть созданы.
- Since:
- 9
toString
equals
hashCode
© 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.