Класс Font

public static final String DIALOG

Начиная с:

1.6

См. также:

• Значения констант полей

public static final String DIALOG_INPUT

Начиная с:

1.6

См. также:

• Значения констант полей

public static final String SANS_SERIF

Начиная с:

1.6

См. также:

• Значения констант полей

public static final String SERIF

Начиная с:

1.6

См. также:

• Значения констант полей

public static final String MONOSPACED

Начиная с:

1.6

См. также:

• Значения констант полей

public static final int PLAIN

См. также:

• Значения констант полей

public static final int BOLD

См. также:

• Значения констант полей

public static final int ITALIC

См. также:

• Значения констант полей

public static final int ROMAN_BASELINE

См. также:

• Значения констант полей

public static final int CENTER_BASELINE

См. также:

• Значения констант полей

public static final int HANGING_BASELINE

См. также:

• Значения констант полей

public static final int TRUETYPE_FONT

Начиная с:

1.3

См. также:

• Значения констант полей

public static final int TYPE1_FONT

Начиная с:

1.5

См. также:

• Значения констант полей

protected String name

Начиная с:

1.0

См. также:

• getName()

protected int style

Начиная с:

1.0

См. также:

• getStyle()

protected int size

Начиная с:

1.0

См. также:

• getSize()

protected float pointSize

См. также:

• getSize()
• getSize2D()

public static final int LAYOUT_LEFT_TO_RIGHT

См. также:

• Значения констант полей

public static final int LAYOUT_RIGHT_TO_LEFT

См. также:

• Значения констант полей

public static final int LAYOUT_NO_START_CONTEXT

См. также:

• Значения констант полей

public static final int LAYOUT_NO_LIMIT_CONTEXT

См. также:

• Значения констант полей

public Font(String name, int style, int size)

Параметры:

name — имя шрифта. Это может быть названием гарнитуры или семейства шрифтов, а также может представлять логический или физический шрифт, найденный в этой GraphicsEnvironment. Имена семейств логических шрифтов: Dialog, DialogInput, Monospaced, Serif или SansSerif. Для всех этих имен определены предварительно заданные строковые константы, например, DIALOG. Если name имеет значение null, логическое имя шрифта нового Font, возвращаемое методом getName(), устанавливается равным имени "Default".

style — константа начертания для Font. Аргумент начертания представляет собой целочисленную битовую маску, которая может иметь значение PLAIN или быть побитовым объединением BOLD и/или ITALIC (например, ITALIC или BOLD|ITALIC). Если аргумент начертания не соответствует одной из ожидаемых целочисленных битовых масок, для начертания устанавливается значение PLAIN.

size — размер Font в пунктах

Начиная с:

1.0

См. также:

• GraphicsEnvironment.getAllFonts()
• GraphicsEnvironment.getAvailableFontFamilyNames()

public Font(Map<? extends AttributedCharacterIterator.Attribute, ?> attributes)

Параметры:

attributes — атрибуты, назначаемые новому Font, или null

См. также:

• TextAttribute

protected Font(Font font)

Параметры:

font — источник, из которого создается этот Font.

Исключения:

NullPointerException — если font равен null

Начиная с:

1.6

public static boolean textRequiresLayout(char[] chars, int start, int end)

Font.textRequiresLayout(chars, 0, chars.length);

Параметры:

chars — текст.

start — индекс первого проверяемого символа.

end — конечный индекс, не включаемый в диапазон.

Возвращает:

true, если для указанного текста требуется специальная обработка макета.

Исключения:

NullPointerException — если chars равен null.

ArrayIndexOutOfBoundsException — если start отрицателен или end больше длины массива chars.

Начиная с:

9

public static Font getFont(Map<? extends AttributedCharacterIterator.Attribute, ?> attributes)

Параметры:

attributes — атрибуты, назначаемые новому Font

Возвращает:

новый Font, созданный с указанными атрибутами

Исключения:

NullPointerException — если attributes равен null.

Начиная с:

1.2

См. также:

• TextAttribute

public static Font[] createFonts(InputStream fontStream) throws FontFormatException, IOException

Параметры:

fontStream — объект InputStream, представляющий входные данные для шрифта или коллекции шрифтов.

Возвращает:

новый Font[].

Исключения:

FontFormatException — если данные fontStream не содержат необходимых таблиц шрифта для какого-либо элемента коллекции или если не содержат ни одного шрифта.

IOException — если fontStream не удается полностью прочитать.

Начиная с:

9

См. также:

• GraphicsEnvironment.registerFont(Font)

public static Font[] createFonts(File fontFile) throws FontFormatException, IOException

Параметры:

fontFile — объект File, содержащий входные данные для шрифта или коллекции шрифтов.

Возвращает:

новый Font[].

Исключения:

FontFormatException — если File не содержит необходимых таблиц шрифта для какого-либо элемента коллекции или если не содержит ни одного шрифта.

IOException — если fontFile не удается прочитать.

Начиная с:

9

См. также:

• GraphicsEnvironment.registerFont(Font)

public static Font createFont(int fontFormat, InputStream fontStream) throws FontFormatException, IOException

Параметры:

fontFormat — тип Font: TRUETYPE_FONT, если указан ресурс TrueType, или TYPE1_FONT, если указан ресурс Type 1.

fontStream — объект InputStream, представляющий входные данные для шрифта.

Возвращает:

новый Font, созданный с указанным типом шрифта.

Исключения:

IllegalArgumentException — если fontFormat не является ни TRUETYPE_FONT, ни TYPE1_FONT.

FontFormatException — если данные fontStream не содержат необходимых таблиц шрифта для указанного формата.

IOException — если fontStream не удается полностью прочитать.

Начиная с:

1.3

См. также:

• GraphicsEnvironment.registerFont(Font)

public static Font createFont(int fontFormat, File fontFile) throws FontFormatException, IOException

Параметры:

fontFormat — тип Font: TRUETYPE_FONT, если указан ресурс TrueType, или TYPE1_FONT, если указан ресурс Type 1. Пока возвращенный шрифт или производные от него шрифты используются, реализация может продолжать обращаться к fontFile для получения данных шрифта. Поэтому результаты не определены, если файл изменен или становится недоступным.

Чтобы сделать Font доступным конструкторам Font, возвращенный Font необходимо зарегистрировать в GraphicsEnvironment, вызвав registerFont(Font).

fontFile — объект File, представляющий входные данные для шрифта.

Возвращает:

новый Font, созданный с указанным типом шрифта.

Исключения:

IllegalArgumentException — если fontFormat не является ни TRUETYPE_FONT, ни TYPE1_FONT.

NullPointerException — если fontFile равен null.

IOException — если fontFile не удается прочитать.

FontFormatException — если fontFile не содержит необходимых таблиц шрифта для указанного формата.

Начиная с:

1.5

См. также:

• GraphicsEnvironment.registerFont(Font)

public AffineTransform getTransform()

Возвращает:

объект AffineTransform, представляющий атрибут преобразования этого объекта Font.

public String getFamily()

Возвращает:

объект String, представляющий имя семейства этого Font.

Начиная с:

1.1

См. также:

• getName()
• getFontName()

public String getFamily(Locale l)

Параметры:

l — локаль, для которой нужно получить имя семейства

Возвращает:

объект String, представляющий имя семейства шрифта, локализованное для указанной локали.

Начиная с:

1.2

См. также:

• getFontName()
• Locale

public String getPSName()

Возвращает:

значение String, представляющее имя PostScript этого Font.

Начиная с:

1.2

public String getName()

Возвращает:

значение String, представляющее логическое имя этого Font.

Начиная с:

1.0

См. также:

• getFamily()
• getFontName()

public String getFontName()

Возвращает:

значение String, представляющее имя начертания этого Font.

Начиная с:

1.2

См. также:

• getFamily()
• getName()

public String getFontName(Locale l)

Параметры:

l — локаль, для которой нужно получить имя начертания

Возвращает:

значение String, представляющее имя начертания, локализованное для указанной локали.

См. также:

• getFamily()
• Locale

public int getStyle()

Возвращает:

стиль этого Font

Начиная с:

1.0

См. также:

• isPlain()
• isBold()
• isItalic()

public int getSize()

Возвращает:

размер этого Font в пунктах, выраженный в единицах 1/72 дюйма.

Начиная с:

1.0

См. также:

• getSize2D()
• GraphicsConfiguration.getDefaultTransform()
• GraphicsConfiguration.getNormalizingTransform()

public float getSize2D()

Возвращает:

размер этого Font в пунктах в виде значения float.

Начиная с:

1.2

См. также:

• getSize()

public boolean isPlain()

Возвращает:

true, если этот Font имеет стиль PLAIN; в противном случае — false.

Начиная с:

1.0

См. также:

• getStyle()

public boolean isBold()

Возвращает:

true, если стиль этого объекта Font имеет значение BOLD; в противном случае — false.

Начиная с:

1.0

См. также:

• getStyle()

public boolean isItalic()

Возвращает:

true, если стиль этого объекта Font имеет значение ITALIC; в противном случае — false.

Начиная с:

1.0

См. также:

• getStyle()

public boolean isTransformed()

Возвращает:

true, если этот объект Font имеет атрибут AffineTransform, отличный от тождественного. В противном случае — false.

Начиная с:

1.4

См. также:

• getTransform()

public boolean hasLayoutAttributes()

Возвращает:

true, если шрифт содержит атрибуты компоновки

Начиная с:

1.6

public static Font getFont(String nm)

Параметры:

nm — имя свойства

Возвращает:

объект Font, описываемый именем свойства, или null, если такого свойства нет.

Выбрасывает:

NullPointerException — если nm равно null.

Начиная с:

1.2

См. также:

• decode(String)

public static Font decode(String str)

Параметры:

str — имя шрифта или null

Возвращает:

объект Font, описываемый значением str, или новый шрифт Font по умолчанию, если str равно null.

Начиная с:

1.1

См. также:

• getFamily()

public static Font getFont(String nm, Font font)

Параметры:

nm — имя свойства без учёта регистра

font — шрифт Font по умолчанию, возвращаемый, если свойство nm не определено

Возвращает:

значение свойства Font.

Выбрасывает:

NullPointerException — если nm равно null.

См. также:

• decode(String)

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

значение хеш-кода этого Font.

Начиная с:

1.0

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(Object)

public boolean equals(Object obj)

Переопределяет:

equals в классе Object

Параметры:

obj — Object для сравнения

Возвращает:

true, если объекты одинаковы или если аргумент является объектом Font, описывающим тот же шрифт, что и этот объект; в противном случае — false.

Начиная с:

1.0

См. также:

• Object.hashCode()
• HashMap

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

представление String этого объекта Font.

Начиная с:

1.0

public int getNumGlyphs()

Возвращает:

количество глифов в этом Font.

Начиная с:

1.2

public int getMissingGlyphCode()

Возвращает:

glyphCode этого Font.

Начиная с:

1.2

public byte getBaselineFor(char c)

Параметры:

c — символ, используемый для определения системы письма

Возвращает:

базовую линию, подходящую для указанного символа.

Начиная с:

1.2

См. также:

• LineMetrics.getBaselineOffsets()
• ROMAN_BASELINE
• CENTER_BASELINE
• HANGING_BASELINE

public Map<TextAttribute, ?> getAttributes()

Возвращает:

карту атрибутов этого Font.

public AttributedCharacterIterator.Attribute[] getAvailableAttributes()

Возвращает:

массив, содержащий ключи всех атрибутов, поддерживаемых этим Font.

Начиная с:

1.2

public Font deriveFont(int style, float size)

Параметры:

style — стиль нового Font

size — размер нового Font

Возвращает:

новый объект Font.

Начиная с:

1.2

public Font deriveFont(int style, AffineTransform trans)

Параметры:

style — стиль нового Font

trans — AffineTransform, связанное с новым Font

Возвращает:

новый объект Font.

Выбрасывает:

IllegalArgumentException — если trans равно null

Начиная с:

1.2

public Font deriveFont(float size)

Параметры:

size — размер нового Font.

Возвращает:

новый объект Font.

Начиная с:

1.2

public Font deriveFont(AffineTransform trans)

Параметры:

trans — AffineTransform, связанное с новым Font

Возвращает:

новый объект Font.

Выбрасывает:

IllegalArgumentException — если trans равно null

Начиная с:

1.2

public Font deriveFont(int style)

Параметры:

style — стиль нового Font

Возвращает:

новый объект Font.

Начиная с:

1.2

public Font deriveFont(Map<? extends AttributedCharacterIterator.Attribute, ?> attributes)

Параметры:

attributes — карта атрибутов, включённых для нового Font

Возвращает:

новый объект Font.

Начиная с:

1.2

public boolean canDisplay(char c)

Параметры:

c — символ, для которого требуется глиф

Возвращает:

true, если в этом Font есть глиф для данного символа; в противном случае — false.

Начиная с:

1.2

public boolean canDisplay(int codePoint)

Параметры:

codePoint — символ (кодовая точка Unicode), для которого требуется глиф.

Возвращает:

true, если в этом Font есть глиф для данного символа; в противном случае — false.

Выбрасывает:

IllegalArgumentException — если кодовая точка не является допустимой кодовой точкой Unicode.

Начиная с:

1.5

См. также:

• Character.isValidCodePoint(int)

public int canDisplayUpTo(String str)

Параметры:

str — объект String

Возвращает:

смещение в str, указывающее на первый символ в str, который этот Font не может отобразить; или -1, если этот Font может отображать все символы в str.

Начиная с:

1.2

public int canDisplayUpTo(char[] text, int start, int limit)

Параметры:

text — указанный массив значений char

start — указанное начальное смещение (в charах) в указанном массиве значений char

limit — указанное конечное смещение (в charах) в указанном массиве значений char

Возвращает:

смещение в text, указывающее на первый символ в text, который этот Font не может отобразить; или -1, если этот Font может отображать все символы в text.

Начиная с:

1.2

public int canDisplayUpTo(CharacterIterator iter, int start, int limit)

Параметры:

iter — объект CharacterIterator

start — указанное начальное смещение в указанном CharacterIterator.

limit — указанное конечное смещение в указанном CharacterIterator.

Возвращает:

смещение в iter, указывающее на первый символ в iter, который этот Font не может отобразить; или -1, если этот Font может отображать все символы в iter.

Начиная с:

1.2

public float getItalicAngle()

Возвращает:

угол наклона стиля ITALIC этого Font.

См. также:

• TextAttribute.POSTURE

public boolean hasUniformLineMetrics()

Возвращает:

true, если этот Font имеет единообразные метрики строк; в противном случае — false.

public LineMetrics getLineMetrics(String str, FontRenderContext frc)

Параметры:

str — указанный String

frc — указанный FontRenderContext

Возвращает:

объект LineMetrics, созданный с использованием указанного String и FontRenderContext.

public LineMetrics getLineMetrics(String str, int beginIndex, int limit, FontRenderContext frc)

Параметры:

str — указанный String

beginIndex — начальное смещение str

limit — конечное смещение str

frc — указанный FontRenderContext

Возвращает:

объект LineMetrics, созданный с использованием указанных аргументов.

public LineMetrics getLineMetrics(char[] chars, int beginIndex, int limit, FontRenderContext frc)

Параметры:

chars — массив символов

beginIndex — начальное смещение chars

limit — конечное смещение chars

frc — указанный FontRenderContext

Возвращает:

объект LineMetrics, созданный с указанными аргументами.

public LineMetrics getLineMetrics(CharacterIterator ci, int beginIndex, int limit, FontRenderContext frc)

Параметры:

ci — указанный CharacterIterator

beginIndex — начальное смещение в ci

limit — конечное смещение ci

frc — указанный FontRenderContext

Возвращает:

объект LineMetrics, созданный с указанными аргументами.

public Rectangle2D getStringBounds(String str, FontRenderContext frc)

Параметры:

str — указанный String

frc — указанный FontRenderContext

Возвращает:

Rectangle2D, представляющий ограничивающую рамку указанного String в указанном FontRenderContext.

Начиная с:

1.2

См. также:

• FontRenderContext
• createGlyphVector(FontRenderContext, String)

public Rectangle2D getStringBounds(String str, int beginIndex, int limit, FontRenderContext frc)

Параметры:

str — указанный String

beginIndex — начальное смещение str

limit — конечное смещение str

frc — указанный FontRenderContext

Возвращает:

Rectangle2D, представляющий ограничивающую рамку указанного String в указанном FontRenderContext.

Выбрасывает:

IndexOutOfBoundsException — если beginIndex меньше нуля, limit больше длины str или beginIndex больше limit.

Начиная с:

1.2

См. также:

• FontRenderContext
• createGlyphVector(FontRenderContext, String)

public Rectangle2D getStringBounds(char[] chars, int beginIndex, int limit, FontRenderContext frc)

Параметры:

chars — массив символов

beginIndex — начальное смещение в массиве символов

limit — конечное смещение в массиве символов

frc — указанный FontRenderContext

Возвращает:

Rectangle2D, представляющий ограничивающую рамку указанного массива символов в указанном FontRenderContext.

Выбрасывает:

IndexOutOfBoundsException — если beginIndex меньше нуля, limit больше длины chars или beginIndex больше limit.

Начиная с:

1.2

См. также:

• FontRenderContext
• createGlyphVector(FontRenderContext, String)

public Rectangle2D getStringBounds(CharacterIterator ci, int beginIndex, int limit, FontRenderContext frc)

Параметры:

ci — указанный CharacterIterator

beginIndex — начальное смещение в ci

limit — конечное смещение в ci

frc — указанный FontRenderContext

Возвращает:

Rectangle2D, представляющий ограничивающую рамку символов, индексированных в указанном CharacterIterator, в указанном FontRenderContext.

Выбрасывает:

IndexOutOfBoundsException — если beginIndex меньше начального индекса ci, limit больше конечного индекса ci или beginIndex больше limit

Начиная с:

1.2

См. также:

• FontRenderContext
• createGlyphVector(FontRenderContext, String)

public Rectangle2D getMaxCharBounds(FontRenderContext frc)

Параметры:

frc — указанный FontRenderContext

Возвращает:

Rectangle2D, представляющий ограничивающую рамку символа с наибольшими границами.

public GlyphVector createGlyphVector(FontRenderContext frc, String str)

Параметры:

frc — указанный FontRenderContext

str — указанный String

Возвращает:

новый GlyphVector, созданный с использованием указанного String и указанного FontRenderContext.

public GlyphVector createGlyphVector(FontRenderContext frc, char[] chars)

Параметры:

frc — указанный FontRenderContext

chars — указанный массив символов

Возвращает:

новый GlyphVector, созданный с использованием указанного массива символов и указанного FontRenderContext.

public GlyphVector createGlyphVector(FontRenderContext frc, CharacterIterator ci)

Параметры:

frc — указанный FontRenderContext

ci — указанный CharacterIterator

Возвращает:

новый GlyphVector, созданный с использованием указанного CharacterIterator и указанного FontRenderContext.

public GlyphVector createGlyphVector(FontRenderContext frc, int[] glyphCodes)

Параметры:

frc — указанный FontRenderContext

glyphCodes — указанный массив целых чисел

Возвращает:

новый GlyphVector, созданный с использованием указанного массива целых чисел и указанного FontRenderContext.

public GlyphVector layoutGlyphVector(FontRenderContext frc, char[] text, int start, int limit, int flags)

Параметры:

frc — указанный FontRenderContext

text — текст для компоновки

start — начало текста, используемого для GlyphVector

limit — предел текста, используемого для GlyphVector

flags — управляющие флаги, описанные выше

Возвращает:

новый GlyphVector, представляющий текст между началом и пределом диапазона, с выбранными и расположенными глифами, которые наилучшим образом отображают этот текст

Выбрасывает:

ArrayIndexOutOfBoundsException — если начало или предел диапазона выходит за допустимые границы

Начиная с:

1.4

См. также:

• Bidi
• LAYOUT_LEFT_TO_RIGHT
• LAYOUT_RIGHT_TO_LEFT
• LAYOUT_NO_START_CONTEXT
• LAYOUT_NO_LIMIT_CONTEXT