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

См. также:

getBounds()

getDescent

public abstract float getDescent()

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

Возвращает:

нисходящую величину этого GraphicAttribute.

См. также:

getBounds()

getAdvance

public abstract float getAdvance()

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

Возвращает:

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

См. также:

getBounds()

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, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/font/GraphicAttribute.html