javafx.scene.text

Класс 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.
`String`	`getFamily()` Возвращает семейство данного шрифта.
`static List<String>`	`getFontNames()` Получает имена всех шрифтов, установленных на системе пользователя, включая шрифты приложений и SDK.
`static List<String>`	`getFontNames(String family)` Получает имена всех шрифтов в указанном семействе шрифтов, установленных на системе пользователя, включая шрифты приложений и SDK.
`String`	`getName()` Полное имя шрифта.
`double`	`getSize()` Размер шрифта в пунктах.
`String`	`getStyle()` Строка, описывающая стиль шрифта внутри семейства.
`int`	`hashCode()` Возвращает хэш-код для данного объекта шрифта.
`static Font`	`loadFont(InputStream in, double size)` Загружает ресурс шрифта из указанного потока ввода.
`static Font`	`loadFont(String urlStr, double size)` Загружает ресурс шрифта из указанной URL-адреса.
`String`	`toString()` Преобразует этот объект шрифта в представление `String`.

Наследуемые методы от класса java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

Подробное описание метода
- getDefault
```
public static Font getDefault()
```
  Возвращает шрифт по умолчанию, который будет из семейства "System", обычно со стилем "Regular" и размером, соответствующим пользовательской операционной среде, насколько это возможно определить.
  
  Возвращает:
  
  Шрифт по умолчанию.
- getFamilies
```
public static List<String> getFamilies()
```
  Возвращает все установленные на системе пользователя шрифтовые семейства, включая шрифты приложений и SDK-шрифты. Этот вызов имеет аспекты производительности, так как поиск всех шрифтов может быть дорогостоящей операцией в первый раз.
  
  Возвращает:
  
  Список всех доступных шрифтовых семейств.
- getFontNames
```
public static List<String> getFontNames()
```
  Возвращает имена всех установленных на системе пользователя шрифтов, включая шрифты приложений и SDK-шрифты. Этот вызов имеет аспекты производительности, так как поиск всех шрифтов может быть дорогостоящей операцией в первый раз.
  
  Возвращает:
  
  Список всех доступных шрифтов.
- getFontNames
```
public static List<String> getFontNames(String family)
```
  Возвращает имена всех шрифтов в указанном семействе шрифтов, установленных на системе пользователя, включая шрифты приложений и SDK-шрифты. Этот вызов имеет аспекты производительности, так как поиск всех шрифтов может быть дорогостоящей операцией в первый раз.
  
  Возвращает:
  
  Список шрифтов для данного семейства.
- font
```
public static Font font(String family,
                        FontWeight weight,
                        FontPosture posture,
                        double size)
```
  Ищет подходящий шрифт на основе имени семейства шрифтов, а также стиля начертания и наклона. Данный метод не гарантирует возвращения конкретного шрифта, но делает все возможное, чтобы найти шрифт, соответствующий заданным требованиям.
  Значение null или пустая строка для семейства позволяет реализации выбрать любой подходящий шрифт.
  
  Параметры:
  
  family - Семейство шрифта
  
  Возвращает:
  
  Шрифт, наилучшим образом соответствующий заданным требованиям.
- font
```
public static Font font(String family,
                        FontWeight weight,
                        double size)
```
  Ищет подходящий шрифт на основе имени семейства шрифтов и стиля начертания. Данный метод не гарантирует возвращения конкретного шрифта, но делает все возможное, чтобы найти шрифт, соответствующий заданным требованиям. Значение null или пустая строка для семейства позволяет реализации выбрать любой подходящий шрифт.
  
  Параметры:
  
  family - Семейство шрифта
  
  Возвращает:
  
  Шрифт, наилучшим образом соответствующий заданным требованиям.
- font
```
public static Font font(String family,
                        FontPosture posture,
                        double size)
```
  Ищет подходящий шрифт на основе имени семейства шрифтов и стиля наклона. Данный метод не гарантирует возвращения конкретного шрифта, но делает все возможное, чтобы найти шрифт, соответствующий заданным требованиям. Значение null или пустая строка для семейства позволяет реализации выбрать любой подходящий шрифт.
  
  Параметры:
  
  family - Семейство шрифта
  
  Возвращает:
  
  Шрифт, наилучшим образом соответствующий заданным требованиям.
- font
```
public static Font font(String family,
                        double size)
```
  Ищет подходящий шрифт на основе имени семейства шрифтов и размера. Данный метод не гарантирует возвращения конкретного шрифта, но делает все возможное, чтобы найти шрифт, соответствующий заданным требованиям. Значение null или пустая строка для семейства позволяет реализации выбрать любой подходящий шрифт.
  
  Параметры:
  
  family - Семейство шрифта
  
  Возвращает:
  
  Шрифт, наилучшим образом соответствующий заданным требованиям.
- 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, и установленные системные шрифты. Просто создайте шрифт, указав полное имя шрифта, который вы хотите загрузить. Если конкретный шрифт не найден, будет использован резервный или шрифт по умолчанию. Имя будет обновлено, чтобы отразить фактическое имя используемого шрифта. Обнаружение ошибки загрузки можно определить, проверив имя шрифта с именем, которое вы пытались загрузить.
  
  Обратите внимание, что если вы хотите найти шрифт по семейству шрифтов и стилю, то вы можете использовать один из методов фабрики 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. Приложение должно проверить это перед использованием.
  
  При успешном (не null) возврате шрифт будет зарегистрирован в системе графики FX для создания с помощью доступных конструкторов и методов фабрики, и приложение должно использовать его таким образом, а не вызывать этот метод снова, что повторит затраты на загрузку и установку шрифта.
  
  Параметр шрифта size — это удобство, чтобы в типичном использовании приложение могло непосредственно использовать возвращаемый (не null) шрифт, а не создавать его через конструктор. Недопустимые размеры — это те, что ≤ 0, и приведут к использованию размера по умолчанию.
  
  Если URL представляет собой локальный файл на диске, то копирование не выполняется, и файл шрифта должен сохраняться на протяжении всего срока жизни приложения. Обновление файла любым способом приведёт к неопределённому и, вероятно, нежелательному поведению.
  
  Параметры:
  
  urlStr - откуда загружать шрифт, указано как строка.
  
  Возвращает:
  
  шрифт, или null, если шрифт не может быть создан.
- loadFont
```
public static Font loadFont(InputStream in,
                            double size)
```
  Загружает ресурс шрифта из указанного потока ввода. Если загрузка успешна, поток ввода может быть полностью прочитан, и он представляет поддерживаемый формат шрифта, возвращается объект Font.
  Если у приложения нет соответствующих разрешений, этот метод вернёт системный шрифт по умолчанию с указанным размером шрифта.
  
  Любая ошибка, такая как неполный ввод или неподдерживаемый формат шрифта, приведёт к возвращению null. Приложение должно проверить это перед использованием.
  
  При успешном (не null) возврате шрифт будет зарегистрирован в системе графики FX для создания с помощью доступных конструкторов и методов фабрики, и приложение должно использовать его таким образом, а не вызывать этот метод снова, что повторит затраты на повторное чтение и установку шрифта.
  
  Параметр шрифта size — это удобство, чтобы в типичном использовании приложение могло непосредственно использовать возвращаемый (не null) шрифт, а не создавать его через конструктор. Недопустимые размеры — это те, что ≤ 0, и приведут к использованию размера по умолчанию.
  
  Этот метод не закрывает поток ввода.
  
  Параметры:
  
  in - поток ввода для загрузки шрифта.
  
  Возвращает:
  
  шрифт, или null, если шрифт не может быть создан.
- toString
```
public String toString()
```
  Преобразует этот объект Font в строковое представление String. Строковое представление предназначено только для информационных целей и может измениться. Не используйте это строковое представление для каких-либо программных целей.
  
  Переопределяет:
  
  toString в классе Object
- equals
```
public boolean equals(Object obj)
```
  Указывает, является ли некоторый другой объект "равным" этому.
  
  Переопределяет:
  
  equals в классе Object
  
  Параметры:
  
  obj - объект-ссылка для сравнения.
  
  Возвращает:
  
  true, если этот объект равен аргументу obj; false в противном случае.

- hashCode
```
public int hashCode()
```
  Возвращает код хэша для этого Font объекта.
  
  Переопределяет:
  
  hashCode в классе Object
  
  Возвращает:
  
  код хэша для этого 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.

Класс Font

Краткое описание конструкторов

Краткое описание методов

Наследуемые методы от класса java.lang.Object

Подробное описание конструкторов

Font

Font

Подробное описание метода

getDefault

getFamilies

getFontNames

getFontNames

font

font

font

font

font

font

getName

getFamily

getStyle

getSize

loadFont

loadFont

toString

equals

hashCode