Класс GraphicAttribute

java.lang.Object

java.awt.font.GraphicAttribute

Прямые известные подклассы:: ImageGraphicAttribute, ShapeGraphicAttribute

public abstract class GraphicAttribute extends Object

Этот класс используется с атрибутом CHAR_REPLACEMENT.

Класс GraphicAttribute представляет графический элемент, встроенный в текст. Клиенты наследуют этот класс для реализации собственных графических элементов замены символов. Клиентам, желающим встраивать фигуры и изображения в текст, нет необходимости наследовать этот класс. Вместо этого клиенты могут использовать классы ShapeGraphicAttribute и ImageGraphicAttribute.

Подклассы должны гарантировать, что их объекты неизменяемы после создания. Изменение GraphicAttribute, используемого в TextLayout, приводит к неопределенному поведению TextLayout.

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`BOTTOM_ALIGNMENT`	Выравнивает нижнюю часть графика с нижней частью строки.
`static final int`	`CENTER_BASELINE`	Выравнивает начало графика по центральной базовой линии строки.
`static final int`	`HANGING_BASELINE`	Выравнивает начало графика по подвешенной базовой линии строки.
`static final int`	`ROMAN_BASELINE`	Выравнивает начало графика по римской базовой линии строки.
`static final int`	`TOP_ALIGNMENT`	Выравнивает верхнюю часть графика с верхней частью строки.

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

GraphicAttribute(int alignment)

Модификатор	Конструктор	Описание
`protected`	Создает `GraphicAttribute`.

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

Модификатор и тип	Метод	Описание
`abstract void`	`draw(Graphics2D graphics, float x, float y)`	Отображает этот `GraphicAttribute` в указанном месте.
`abstract float`	`getAdvance()`	Возвращает отступ этого `GraphicAttribute`.
`final int`	`getAlignment()`	Возвращает выравнивание этого `GraphicAttribute`.
`abstract float`	`getAscent()`	Возвращает восходящую часть этого `GraphicAttribute`.
`Rectangle2D`	`getBounds()`	Возвращает `Rectangle2D`, который охватывает все биты, нарисованные этим `GraphicAttribute` относительно позиции рендеринга.
`abstract float`	`getDescent()`	Возвращает нисходящую часть этого `GraphicAttribute`.
`GlyphJustificationInfo`	`getJustificationInfo()`	Возвращает информацию о выравнивании для этого `GraphicAttribute`.
`Shape`	`getOutline(AffineTransform tx)`	Возвращает `Shape`, представляющий область, которую отображает этот `GraphicAttribute`.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

TOP_ALIGNMENT

public static final int TOP_ALIGNMENT

Выравнивает верхнюю часть графики по верхнему краю строки.

См. также:

BOTTOM_ALIGNMENT

public static final int BOTTOM_ALIGNMENT

Выравнивает нижнюю часть графики по нижнему краю строки.

См. также:

ROMAN_BASELINE

public static final int ROMAN_BASELINE

Выравнивает начало графики по римской (обычной) базовой линии строки.

См. также:

CENTER_BASELINE

public static final int CENTER_BASELINE

Выравнивает начало графики по центральной базовой линии строки.

См. также:

HANGING_BASELINE

public static final int HANGING_BASELINE

Выравнивает начало графики по подвешенной базовой линии строки.

См. также:

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

GraphicAttribute

protected GraphicAttribute(int alignment)

Создаёт GraphicAttribute. Подклассы используют это для определения выравнивания графики.

Параметры:: alignment - целое число, представляющее одно из полей выравнивания GraphicAttribute
Исключения:: IllegalArgumentException - если выравнивание не совпадает с одним из пяти определённых значений.

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

getAscent

public abstract float getAscent()

Возвращает восходящую часть этого GraphicAttribute. Графика может быть отрисована выше своей восходящей части.

Возвращает:

восходящую часть этого GraphicAttribute.

См. также:

getDescent

public abstract float getDescent()

Возвращает нисходящую часть этого GraphicAttribute. Графика может быть отрисована ниже своей нисходящей части.

Возвращает:

нисходящую часть этого GraphicAttribute.

См. также:

getAdvance

public abstract float getAdvance()

Возвращает продвижение этого GraphicAttribute. Продвижение объекта GraphicAttribute — расстояние от точки, где отображается графика, до точки, где отображается следующий символ или графика. Графика может быть отрисована за пределами своего продвижения.

Возвращает:

продвижение этого GraphicAttribute.

См. также:

getBounds

public Rectangle2D getBounds()

Возвращает Rectangle2D, который охватывает все биты, нарисованные этим GraphicAttribute относительно позиции отрисовки. Графика может быть отрисована за пределами своей начальной точки, восходящей, нисходящей или продвижения, но в этом случае реализация метода должна указать, где графика отрисована. По умолчанию прямоугольник (0, -восходящая, продвижение, восходящая+нисходящая).

Возвращает:: Rectangle2D, который охватывает все отрисованные биты этим GraphicAttribute.

getOutline

public Shape getOutline(AffineTransform tx)

Возвращает Shape, который представляет область, которую отрисовывает этот GraphicAttribute. Используется, когда TextLayout запрошен для возвращения контура текста. (Непреобразованная) фигура не должна выходить за пределы прямоугольной области, возвращаемой getBounds. Реализация по умолчанию возвращает прямоугольник, возвращённый getBounds(), преобразованный предоставленным AffineTransform, если он есть.

Параметры:: tx - необязательный AffineTransform для применения к контуру этого GraphicAttribute. Может быть null.
Возвращает:: Shape, представляющий эту атрибут графики, пригодный для обводки или заполнения.
С:: 1.6

draw

public abstract void draw(Graphics2D graphics, float x, float y)

Отображает этот GraphicAttribute в заданном месте.

Параметры:: graphics - Graphics2D, в котором нужно отобразить графику; x - координата X в пространстве пользователя, где отображается графика; y - координата Y в пространстве пользователя, где отображается графика

getAlignment

public final int getAlignment()

Возвращает выравнивание этого GraphicAttribute. Выравнивание может быть по определённой базовой линии или по абсолютному верху или низу строки.

Возвращает:: выравнивание этого GraphicAttribute.

getJustificationInfo

public GlyphJustificationInfo getJustificationInfo()

Возвращает информацию о выравнивании для этого GraphicAttribute. Подклассы могут переопределять этот метод для предоставления различной информации о выравнивании.

Возвращает:: объект GlyphJustificationInfo, содержащий информацию о выравнивании для этого GraphicAttribute.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/font/GraphicAttribute.html