Класс 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, 2023, 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/21/docs/api/java.desktop/java/awt/font/GraphicAttribute.html