Spec-Zone.ru › OpenJDK 25

Класс GlyphView.GlyphPainter

java.lang.Object
javax.swing.text.GlyphView.GlyphPainter
Внешний класс:
GlyphView
public abstract static class GlyphView.GlyphPainter extends Object
Класс для отрисовки глифов. Он может быть реализован без сохранения состояния или хранить некоторую информацию в кэше для ускорения отрисовки и преобразования между моделью и представлением. Как минимум, GlyphPainter позволяет реализации View выполнять свои задачи независимо от конкретной версии JVM и набора доступных возможностей (например, формирования текста для интернационализации и т. д.).
Начиная с:
1.3

Краткое описание конструкторов

GlyphPainter()
Модификатор Конструктор Описание
protected
Конструктор, который вызывают подклассы.

Краткое описание методов

Модификатор и тип Метод Описание
abstract float getAscent(GlyphView v)
Возвращает величину верхнего выноса.
abstract int getBoundedPosition(GlyphView v, int p0, float x, float len)
Определяет позицию в модели, соответствующую максимальному продвижению, которое помещается в заданный интервал.
abstract float getDescent(GlyphView v)
Возвращает величину нижнего выноса.
abstract float getHeight(GlyphView v)
Возвращает высоту.
int getNextVisualPositionFrom(GlyphView v, int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)
Позволяет определить следующую визуально отображаемую позицию в модели, в которую можно поместить каретку.
GlyphView.GlyphPainter getPainter(GlyphView v, int p0, int p1)
Создает средство отрисовки для заданного GlyphView.
abstract float getSpan(GlyphView v, int p0, int p1, TabExpander e, float x)
Определяет длину глифов для заданной начальной позиции (при расширении табуляции).
abstract Shape modelToView(GlyphView v, int pos, Position.Bias bias, Shape a)
Обеспечивает преобразование из координатного пространства модели документа в координатное пространство соответствующего ей представления.
abstract void paint(GlyphView v, Graphics g, Shape a, int p0, int p1)
Отрисовывает глифы, представляющие заданный диапазон.
abstract int viewToModel(GlyphView v, float x, float y, Shape a, Position.Bias[] biasReturn)
Обеспечивает преобразование из координатного пространства представления в логическое координатное пространство модели.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

GlyphPainter

protected GlyphPainter()
Конструктор, который вызывают подклассы.

Подробное описание методов

getSpan

public abstract float getSpan(GlyphView v, int p0, int p1, TabExpander e, float x)
Определяет длину глифов для заданной начальной позиции (при расширении табуляции).
Параметры:
v — GlyphView
p0 — начальная позиция
p1 — конечная позиция
e — способ расширения табуляции при ее обнаружении
x — координата X
Возвращает:
длину глифов для заданной начальной позиции

getHeight

public abstract float getHeight(GlyphView v)
Возвращает высоту.
Параметры:
v — GlyphView
Возвращает:
высоту

getAscent

public abstract float getAscent(GlyphView v)
Возвращает величину верхнего выноса.
Параметры:
v — GlyphView
Возвращает:
величину верхнего выноса

getDescent

public abstract float getDescent(GlyphView v)
Возвращает величину нижнего выноса.
Параметры:
v — GlyphView
Возвращает:
величину нижнего выноса

paint

public abstract void paint(GlyphView v, Graphics g, Shape a, int p0, int p1)
Отрисовывает глифы, представляющие заданный диапазон.
Параметры:
v — GlyphView
g — графический контекст
a — текущая область, выделенная для представления
p0 — начальная позиция
p1 — конечная позиция

modelToView

public abstract Shape modelToView(GlyphView v, int pos, Position.Bias bias, Shape a) throws BadLocationException
Обеспечивает преобразование из координатного пространства модели документа в координатное пространство соответствующего ей представления. Этот метод используется совместно разорванными представлениями.
Параметры:
v — GlyphView, содержащая целевое координатное пространство
pos — позиция для преобразования
bias — либо Position.Bias.Forward, либо Position.Bias.Backward
a — границы представления
Возвращает:
ограничивающий прямоугольник заданной позиции
Вызывает:
BadLocationException — если заданная позиция не соответствует допустимому местоположению в связанном документе
См. также:
  • View.modelToView(int, Shape, Position.Bias)

viewToModel

public abstract int viewToModel(GlyphView v, float x, float y, Shape a, Position.Bias[] biasReturn)
Обеспечивает преобразование из координатного пространства представления в логическое координатное пространство модели.
Параметры:
v — GlyphView, для которого нужно выполнить преобразование
x — координата X
y — координата Y
a — выделенная область для отрисовки
biasReturn — либо Position.Bias.Forward, либо Position.Bias.Backward возвращается в качестве нулевого элемента этого массива
Возвращает:
позицию в модели, которая лучше всего соответствует заданной точке представления
См. также:
  • View.viewToModel(float, float, Shape, Position.Bias[])

getBoundedPosition

public abstract int getBoundedPosition(GlyphView v, int p0, float x, float len)
Определяет позицию в модели, соответствующую максимальному продвижению, которое помещается в заданный интервал. Это можно использовать для разбиения заданного представления. Результат должен указывать позицию немного раньше заданного продвижения. Этот метод отличается от viewToModel, который возвращает ближайшую позицию, которая может выходить за пределы максимального продвижения.
Параметры:
v — представление, для которого нужно найти позицию разбиения в модели.
p0 — позиция в модели, с которой должно начинаться отображение фрагмента >= 0.
x — графическая позиция вдоль оси, которую занимало бы разорванное представление >= 0. Это может пригодиться, например, при вычислении позиций табуляции.
len — задает расстояние от начала представления до предполагаемого места разбиения >= 0.
Возвращает:
максимально возможную позицию разбиения в модели.
См. также:
  • View.breakView(int, int, float, float)

getPainter

public GlyphView.GlyphPainter getPainter(GlyphView v, int p0, int p1)
Создает средство отрисовки для заданного GlyphView. Если средство отрисовки хранит состояние, оно может создать другое средство отрисовки для нового создаваемого GlyphView. Если средство отрисовки не хранит существенного состояния, оно может вернуть себя. По умолчанию возвращается то же средство отрисовки.
Параметры:
v — GlyphView, для которого нужно предоставить средство отрисовки
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 — при недопустимом направлении

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/text/GlyphView.GlyphPainter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API