Класс GlyphView.GlyphPainter
java.lang.Object
javax.swing.text.GlyphView.GlyphPainter
- Внешний класс:
GlyphView
public abstract static class GlyphView.GlyphPainter extends Object
Класс для отображения глифов. Его реализация может быть без сохранения состояния или хранить некоторую информацию в кэше, чтобы ускорить отображение и преобразование между моделью и представлением. Как минимум, GlyphPainter позволяет реализации View выполнять свои задачи независимо от конкретной версии JVM и набора поддерживаемых возможностей (например, формирования текста для интернационализации и т. д.).
- Начиная с версии:
- 1.3
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Конструктор для вызова из подклассов. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract float |
getAscent |
Возвращает величину восхождения. |
abstract int |
getBoundedPosition |
Определяет позицию в модели, соответствующую максимальному смещению, которое помещается в заданный интервал. |
abstract float |
getDescent |
Возвращает величину нисхождения. |
abstract float |
getHeight |
Возвращает высоту. |
int |
getNextVisualPositionFrom |
Позволяет определить следующую визуально представленную позицию модели, в которой можно разместить курсор. |
GlyphView.GlyphPainter |
getPainter |
Создает средство отрисовки для указанного GlyphView. |
abstract float |
getSpan |
Определяет интервал, занимаемый глифами, с учетом начальной позиции (для расширения табуляции). |
abstract Shape |
modelToView |
Преобразует координаты пространства модели документа в координаты пространства соответствующего ей представления. |
abstract void |
paint |
Отображает глифы, представляющие указанный диапазон. |
abstract int |
viewToModel |
Преобразует координаты пространства представления в логические координаты пространства модели. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создает и возвращает копию этого объекта. |
boolean |
equals |
Указывает, равен ли этот объект другому объекту. |
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 |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
Подробное описание конструкторов
GlyphPainter
protected GlyphPainter()
Конструктор для вызова из подклассов.
Подробное описание методов
getSpan
public abstract float getSpan(GlyphView v, int p0, int p1, TabExpander e, float x)
Определяет интервал, занимаемый глифами, с учетом начальной позиции (для расширения табуляции).
- Параметры:
-
v— theGlyphView -
p0— начальная позиция -
p1— конечная позиция -
e— способ расширения табуляции при ее обнаружении -
x— координата X - Возвращает:
- интервал, занимаемый глифами, с учетом начальной позиции
getHeight
public abstract float getHeight(GlyphView v)
Возвращает высоту.
- Параметры:
-
v— theGlyphView - Возвращает:
- высоту
getAscent
public abstract float getAscent(GlyphView v)
Возвращает величину восхождения.
- Параметры:
-
v— theGlyphView - Возвращает:
- величину восхождения
getDescent
public abstract float getDescent(GlyphView v)
Возвращает величину нисхождения.
- Параметры:
-
v— theGlyphView - Возвращает:
- величину нисхождения
paint
public abstract void paint(GlyphView v, Graphics g, Shape a, int p0, int p1)
Отображает глифы, представляющие указанный диапазон.
- Параметры:
-
v— theGlyphView -
g— графический контекст -
a— текущее пространство, выделенное для представления -
p0— начальная позиция -
p1— конечная позиция
modelToView
public abstract Shape modelToView(GlyphView v, int pos, Position.Bias bias, Shape a) throws BadLocationException
Преобразует координаты пространства модели документа в координаты пространства соответствующего ей представления. Этот метод используется совместно разделенными представлениями.
- Параметры:
-
v— theGlyphView, содержащий целевое пространство координат -
pos— позиция для преобразования -
bias— либоPosition.Bias.Forward, либоPosition.Bias.Backward -
a— границы представления - Возвращает:
- ограничивающий прямоугольник указанной позиции
- Выбрасывает исключение:
-
BadLocationException— если указанная позиция не является допустимым местоположением в связанном документе - См. также:
viewToModel
public abstract int viewToModel(GlyphView v, float x, float y, Shape a, Position.Bias[] biasReturn)
Преобразует координаты пространства представления в логические координаты пространства модели.
- Параметры:
-
v— theGlyphView, для которого выполняется преобразование -
x— координата X -
y— координата Y -
a— выделенная область для отрисовки -
biasReturn— либоPosition.Bias.Forward, либоPosition.Bias.Backwardвозвращается в нулевом элементе этого массива - Возвращает:
- позицию в модели, наиболее соответствующую указанной точке представления
- См. также:
getBoundedPosition
public abstract int getBoundedPosition(GlyphView v, int p0, float x, float len)
Определяет позицию в модели, соответствующую максимальному смещению, которое помещается в заданный интервал. Это можно использовать для разбиения указанного представления. Результатом должна быть позиция, немного не достигающая заданного смещения. Этот метод отличается от viewToModel, который возвращает ближайшую позицию, которая может превышать максимальное смещение.
- Параметры:
-
v— представление, для которого требуется найти позицию модели разбиения. -
p0— позиция в модели, с которой должно начинаться отображение фрагмента >= 0. -
x— графическая позиция вдоль оси, которую будет занимать разделенное представление >= 0. Может быть полезна, например, при вычислении табуляции. -
len— задает расстояние от начала представления до предполагаемого места разбиения >= 0. - Возвращает:
- максимально возможную позицию модели для разбиения.
- См. также:
getPainter
public GlyphView.GlyphPainter getPainter(GlyphView v, int p0, int p1)
Создает средство отрисовки для указанного GlyphView. Если средство отрисовки хранит состояние, оно может создать другое средство отрисовки для нового создаваемого GlyphView. Если средство отрисовки не хранит существенного состояния, оно может вернуть само себя. Поведение по умолчанию — вернуть само средство отрисовки.
- Параметры:
-
v— theGlyphView, для которого требуется средство отрисовки -
p0— начальное смещение в документе >= 0 -
p1— конечное смещение в документе >= p0 - Возвращает:
- средство отрисовки для указанного GlyphView
getNextVisualPositionFrom
public int getNextVisualPositionFrom(GlyphView v, int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet) throws BadLocationException
Позволяет определить следующую визуально представленную позицию модели, в которой можно разместить курсор. Некоторые представления могут быть невидимыми, располагаться не в том же порядке, что и в модели, или не предоставлять доступ к некоторым позициям модели.
- Параметры:
-
v— используемое представление -
pos— позиция для преобразования >= 0 -
b— либоPosition.Bias.Forward, либоPosition.Bias.Backward -
a— выделенная область для отрисовки -
direction— направление от текущей позиции, соответствующее клавишам со стрелками на клавиатуре. Это может быть SwingConstants.WEST, SwingConstants.EAST, SwingConstants.NORTH или SwingConstants.SOUTH. -
biasRet— либоPosition.Bias.Forward, либоPosition.Bias.Backwardвозвращается в нулевом элементе этого массива - Возвращает:
- позицию в модели, наиболее точно соответствующую следующей визуальной позиции.
- Выбрасывает исключение:
-
BadLocationException— если указана недопустимая позиция в модели документа -
IllegalArgumentException— если направление недопустимо
© 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.