Spec-Zone.ru › OpenJavaFX 21

Класс 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.
final String getFamily()
Возвращает семейство этого шрифта.
static List<String> getFontNames()
Получает имена всех установленных на системе пользователя шрифтов, включая шрифты приложений и SDK.
static List<String> getFontNames(String family)
Получает имена всех шрифтов в указанном семействе шрифтов, установленных на системе пользователя, включая шрифты приложений и SDK.
final String getName()
Полное имя шрифта.
final double getSize()
Размер шрифта в пунктах.
final 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 в представление String.

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

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

Детали конструкторов

Шрифт

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

Шрифт

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

Детали методов

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

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