Класс 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`.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

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, -ascent, advance, ascent+descent).

Возвращает:: 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.