Класс 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 int`	`BOTTOM_ALIGNMENT`	Выравнивает нижнюю часть графики с нижней частью строки.
`static int`	`CENTER_BASELINE`	Выравнивает начало графики по центральной базовой линии строки.
`static int`	`HANGING_BASELINE`	Выравнивает начало графики по висячей базовой линии строки.
`static int`	`ROMAN_BASELINE`	Выравнивает начало графики по римской базовой линии строки.
`static int`	`TOP_ALIGNMENT`	Выравнивает верхнюю часть графики с верхней частью строки.

Конструкторы

Модификатор	Конструктор	Описание
`protected`	`GraphicAttribute(int alignment)`	Создает объект `GraphicAttribute`.

Методы

Модификатор и тип	Метод	Описание
`abstract void`	`draw(Graphics2D graphics, float x, float y)`	Отображает этот объект `GraphicAttribute` в указанном месте.
`abstract float`	`getAdvance()`	Возвращает смещение этого объекта `GraphicAttribute`.
`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.