Spec-Zone.ru › OpenJavaFX 24

Класс 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 Обычный", а для полужирного Arial - "Arial Полужирный". Точное имя, используемое при загрузке шрифта, определено в каждом файле шрифта как полное имя шрифта. Например, "Proxima Nova ExtraCondensed Полужирный Курсив" относится к конкретному шрифту 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, невозможность найти или прочитать ресурс, или если он не представляет собой шрифт, приведёт к возвращению null. Приложение должно проверить это перед использованием.

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

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

Если URL представляет собой локальный файл на диске, то копирование не выполняется, и файл шрифта должен сохраняться на протяжении всего жизненного цикла приложения. Обновление файла каким-либо образом приведёт к непредсказуемому и, вероятно, нежелательному поведению.

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

loadFonts

public static Font[] loadFonts(String urlStr, double size)
Загружает ресурсы шрифтов из указанного URL. Если загрузка выполнена успешно, местоположение доступно для чтения, и это представляет поддерживаемый формат шрифта, то будет возвращён массив 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

public String toString()
Преобразует этот объект Font в строковое представление. Строковое представление предназначено только для информационных целей и может меняться. Не используйте это строковое представление для каких-либо программных целей.
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 и/или его филиалы. Все права защищены.

© 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