Класс Font
public final class Font
extends Object Класс Font представляет шрифты, которые используются для отображения текста на экране.
Размер Font описывается в пунктах, что является реальной единицей измерения, приблизительно равной 1/72 дюйма.
Учитывая, что шрифты масштабируются с преобразованием рендеринга, определяемым атрибутами преобразования Node, используя Font и его предков, размер фактически будет относительным к локальному пространству координат узла, что должно обеспечить координаты, аналогичные размеру точки, если в окружении узла нет преобразований масштабирования. Обратите внимание, что реальные расстояния, заданные стандартной системой координат, приблизительно соответствуют размеру точки только как ориентир и обычно по умолчанию задаются в пикселях экрана для большинства дисплеев.
Для получения дополнительной информации см. Node для получения дополнительной информации о стандартной системе координат.
- С:
- JavaFX 2.0
Краткое описание конструкторов
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
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 в строковое представление. |
Подробное описание конструкторов
Шрифт
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, и установленных системных шрифтов. Просто создайте шрифт, указав полное имя шрифта, который вы хотите загрузить. Если конкретный шрифт не найден, используется резервный или стандартный шрифт. Имя будет обновлено, чтобы отразить фактическое имя используемого шрифта. Условие неудачи загрузки можно обнаружить, проверив имя шрифта с именем, которое вы пытались загрузить.
Обратите внимание, что если вы хотите найти шрифт по семейству и стилю, вы можете использовать один из 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.