Класс 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) Создаёт объект |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
abstract void |
draw(Graphics2D graphics,
float x,
float y) Отображает этот |
abstract float |
getAdvance() Возвращает продвижение этого |
int |
getAlignment() Возвращает выравнивание этого |
abstract float |
getAscent() Возвращает восходящую часть этого |
Rectangle2D |
getBounds() Возвращает |
abstract float |
getDescent() Возвращает нисходящую часть этого |
GlyphJustificationInfo |
getJustificationInfo() Возвращает информацию о выравнивании для этого |
Shape |
getOutline(AffineTransform tx) Возвращает |
Методы, унаследованные от класса 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, 2020, 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.