Класс GlyphView
- Все реализуемые интерфейсы:
Cloneable, SwingConstants, TabableView
- Непосредственные известные подклассы:
LabelView
public class GlyphView extends View implements TabableView, Cloneable
Представление поддерживает разбиение для целей форматирования. Фрагменты, полученные в результате разбиения, используют общее представление, которое несет основную ответственность за элемент (то есть они являются вложенными классами и содержат лишь небольшое количество собственного состояния), поэтому могут совместно использовать его ресурсы.
Поскольку это представление соответствует тексту, в котором могут находиться табуляции, оно реализует интерфейс TabableView. Табуляции раскрываются только в том случае, если это представление встроено в контейнер, выполняющий раскрытие табуляций. Примером контейнера, выполняющего раскрытие табуляций, является ParagraphView.
- Начиная с:
- 1.3
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
static class |
GlyphView.GlyphPainter |
Класс для отрисовки глифов. |
Краткое описание полей
Поля, объявленные в классе View
BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS | Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
BadBreakWeight |
Вес, указывающий, что представление является нежелательным местом для разрыва при форматировании. |
static final int |
ExcellentBreakWeight |
Вес, указывающий, что представление поддерживает разбиение и является очень подходящим местом для разрыва. |
static final int |
ForcedBreakWeight |
Вес, указывающий, что представление поддерживает разбиение и должно быть разбито для корректного отображения в представлении, форматирующем свои дочерние элементы путем их разбиения. |
static final int |
GoodBreakWeight |
Вес, указывающий, что представление поддерживает разбиение, но, вероятно, существуют более подходящие места для разрыва. |
static final int |
X_AXIS |
Ось для операций форматирования/разбиения. |
static final int |
Y_AXIS |
Ось для операций форматирования/разбиения. |
Поля, объявленные в интерфейсе SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST | Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
BOTTOM |
Константа ориентации прямоугольной области, задающая ее нижнюю границу. |
static final int |
CENTER |
Центральное положение в области. |
static final int |
EAST |
Направление по компасу: восток (вправо). |
static final int |
HORIZONTAL |
Горизонтальная ориентация. |
static final int |
LEADING |
Определяет ведущий край текста для языков с письмом слева направо и справа налево. |
static final int |
LEFT |
Константа ориентации прямоугольной области, задающая ее левую сторону. |
static final int |
NEXT |
Определяет следующее направление в последовательности. |
static final int |
NORTH |
Направление по компасу: север (вверх). |
static final int |
NORTH_EAST |
Направление по компасу: северо-восток (вправо вверх). |
static final int |
NORTH_WEST |
Направление по компасу: северо-запад (влево вверх). |
static final int |
PREVIOUS |
Определяет предыдущее направление в последовательности. |
static final int |
RIGHT |
Константа ориентации прямоугольной области, задающая ее правую сторону. |
static final int |
SOUTH |
Направление по компасу: юг (вниз). |
static final int |
SOUTH_EAST |
Направление по компасу: юго-восток (вправо вниз). |
static final int |
SOUTH_WEST |
Направление по компасу: юго-запад (влево вниз). |
static final int |
TOP |
Константа ориентации прямоугольной области, задающая ее верхнюю границу. |
static final int |
TRAILING |
Определяет замыкающий край текста для языков с письмом слева направо и справа налево. |
static final int |
VERTICAL |
Вертикальная ориентация. |
static final int |
WEST |
Направление по компасу: запад (влево). |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
GlyphView |
Создает новое представление, связанное с элементом. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
View |
breakView |
Разбивает это представление по указанной оси на заданную длину. |
void |
changedUpdate |
Получает от документа уведомление об изменении атрибутов в области, за которую отвечает это представление. |
protected void |
checkPainter() |
Проверяет наличие объекта GlyphPainter. |
protected final Object |
clone() |
Создает поверхностную копию. |
View |
createFragment |
Создает представление, соответствующее части элемента. |
float |
getAlignment |
Определяет желаемое выравнивание этого представления вдоль оси. |
Color |
getBackground() |
Получает цвет фона для отрисовки глифов. |
int |
getBreakWeight |
Определяет, насколько удачно это представление подходит для разрыва. |
int |
getEndOffset() |
Получает часть модели, за которую отвечает это представление. |
Font |
getFont() |
Получает шрифт, который следует использовать для глифов. |
Color |
getForeground() |
Получает цвет переднего плана для отрисовки глифов. |
GlyphView.GlyphPainter |
getGlyphPainter() |
Получает установленный в данный момент объект GlyphPainter. |
float |
getMinimumSpan |
Определяет минимальный размер этого представления вдоль оси. |
int |
getNextVisualPositionFrom |
Предоставляет способ определить следующее визуально представленное расположение в модели, в котором можно разместить курсор. |
float |
getPartialSpan |
Определяет размер части представления вдоль той же оси, что и раскрытие табуляции. |
float |
getPreferredSpan |
Определяет предпочтительный размер этого представления вдоль оси. |
int |
getStartOffset() |
Получает часть модели, за которую отвечает это представление. |
float |
getTabbedSpan |
Определяет желаемый размер при использовании указанной реализации раскрытия табуляции. |
TabExpander |
getTabExpander() |
Получает объект TabExpander, который следует использовать, если в этом представлении есть табуляции. |
Segment |
getText |
Получает ссылку на текст, занимающий указанный диапазон. |
void |
insertUpdate |
Получает уведомление о вставке в документ в области, за которую отвечает это представление. |
boolean |
isStrikeThrough() |
Определяет, следует ли отображать глифы с зачеркиванием. |
boolean |
isSubscript() |
Определяет, следует ли отображать глифы как верхний индекс. |
boolean |
isSuperscript() |
Определяет, следует ли отображать глифы как нижний индекс. |
boolean |
isUnderline() |
Определяет, следует ли подчеркивать глифы. |
Shape |
modelToView |
Преобразует координаты пространства документа в координаты пространства представления, отображаемого для этого документа. |
void |
paint |
Отрисовывает часть фрагмента текста с единым стилем. |
void |
removeUpdate |
Получает уведомление об удалении из документа в области, за которую отвечает это представление. |
void |
setGlyphPainter |
Задает средство отрисовки для глифов. |
int |
viewToModel |
Преобразует координаты пространства представления в логические координаты пространства модели. |
Методы, объявленные в классе View
append, forwardUpdate, forwardUpdateToView, getAttributes, getChildAllocation, getContainer, getDocument, getElement, getGraphics, getMaximumSpan, getParent, getResizeWeight, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, setSize, updateChildren, updateLayout, viewToModel | Модификатор и тип | Метод | Описание |
|---|---|---|
void |
append |
Добавляет одно дочернее представление. |
protected void |
forwardUpdate |
Передает указанное DocumentEvent дочерним представлениям, которые необходимо уведомить об изменении модели. |
protected void |
forwardUpdateToView |
Передает DocumentEvent указанному дочернему представлению. |
AttributeSet |
getAttributes() |
Получает атрибуты, используемые при отрисовке. |
Shape |
getChildAllocation |
Получает область размещения указанного дочернего представления. |
Container |
getContainer() |
Получает контейнер, содержащий представление. |
Document |
getDocument() |
Получает модель, связанную с представлением. |
Element |
getElement() |
Получает структурную часть объекта, с которым связано это представление. |
Graphics |
getGraphics() |
Получает Graphics для отрисовки. |
float |
getMaximumSpan |
Определяет максимальный размер этого представления вдоль оси. |
View |
getParent() |
Возвращает родительское представление. |
int |
getResizeWeight |
Определяет возможность изменения размера представления вдоль указанной оси. |
String |
getToolTipText |
Возвращает текст всплывающей подсказки в указанном месте. |
View |
getView |
Получает n-е дочернее представление. |
int |
getViewCount() |
Возвращает количество представлений в этом представлении. |
ViewFactory |
getViewFactory() |
Получает реализацию ViewFactory, обеспечивающую иерархию представлений. |
int |
getViewIndex |
Возвращает индекс дочернего представления, соответствующего указанной позиции в представлении. |
int |
getViewIndex |
Возвращает индекс дочернего представления, соответствующего указанной позиции в модели. |
void |
insert |
Вставляет одно дочернее представление. |
boolean |
isVisible() |
Возвращает логическое значение, указывающее, видно ли представление. |
Shape |
modelToView |
Устарело. |
Shape |
modelToView |
Для указанной области преобразует координаты пространства модели документа в координаты пространства представления. |
void |
preferenceChanged |
Дочерние представления могут вызвать этот метод у родительского представления, чтобы сообщить об изменении предпочтительных параметров и необходимости пересмотреть компоновку. |
void |
remove |
Удаляет одно из дочерних представлений в указанной позиции. |
void |
removeAll() |
Удаляет все дочерние представления. |
void |
replace |
Заменяет дочерние представления. |
void |
setParent |
Задает родительское представление для этого представления. |
void |
setSize |
Задает размер представления. |
protected boolean |
updateChildren |
Обновляет дочерние представления в ответ на уведомление об изменении модели, если запись об изменении относится к элементу, за который отвечает это представление. |
protected void |
updateLayout |
Обновляет компоновку в ответ на уведомление об изменении модели. |
int |
viewToModel |
Устарело. |
Методы, объявленные в классе Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
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, либо до истечения заданного интервала реального времени. |
Подробное описание конструкторов
GlyphView
public GlyphView(Element elem)
- Параметры:
-
elem— элемент
Подробное описание методов
clone
getGlyphPainter
public GlyphView.GlyphPainter getGlyphPainter()
- Возвращает:
- установленный в данный момент GlyphPainter
setGlyphPainter
public void setGlyphPainter(GlyphView.GlyphPainter p)
- Параметры:
-
p— средство отрисовки, используемое для визуализации глифов
getText
public Segment getText(int p0, int p1)
- Параметры:
-
p0— начальное смещение в документе >= 0 -
p1— конечное смещение в документе >= p0 - Возвращает:
Segment, содержащий текст
getBackground
public Color getBackground()
StyledDocument.getBackground, если связанный документ является стилизованным документом; в противном случае возвращается null.- Возвращает:
- цвет фона, используемый для визуализации глифов
getForeground
public Color getForeground()
StyledDocument.getBackground, если связанный документ является StyledDocument. Если связанный документ не является StyledDocument, используется цвет переднего плана связанного компонента. Если связанный компонент отсутствует, возвращается null.- Возвращает:
- цвет переднего плана, используемый для визуализации глифов
getFont
public Font getFont()
StyledDocument.getFont, если связанный документ является StyledDocument. Если связанный документ не является StyledDocument, используется шрифт связанного компонента. Если связанный компонент отсутствует, возвращается null.- Возвращает:
- шрифт, на основе которого следует отображать глифы
isUnderline
public boolean isUnderline()
true, подчеркивание следует провести через базовую линию.- Возвращает:
-
true, если глифы следует подчеркнуть; в противном случае —false
isStrikeThrough
public boolean isStrikeThrough()
true, через центр глифов следует провести линию.- Возвращает:
-
true, если глифы следует перечеркнуть; в противном случае —false
isSubscript
public boolean isSubscript()
- Возвращает:
-
true, если глифы следует отображать в виде верхнего индекса; в противном случае —false
isSuperscript
public boolean isSuperscript()
- Возвращает:
-
true, если глифы следует отображать в виде нижнего индекса; в противном случае —false
getTabExpander
public TabExpander getTabExpander()
- Возвращает:
- TabExpander, используемый, если в этом представлении есть символы табуляции
checkPainter
protected void checkPainter()
getTabbedSpan
public float getTabbedSpan(float x, TabExpander e)
- Определено в:
-
getTabbedSpanв интерфейсеTabableView - Параметры:
-
x— позиция, в которой должно находиться представление для расширения табуляции >= 0. -
e— способ расширения табуляции при ее обнаружении. - Возвращает:
- требуемый размер >= 0
- См. также:
getPartialSpan
public float getPartialSpan(int p0, int p1)
Этот метод может вызываться при обработке getTabbedSpan или getPreferredSize. Для выполнения измерений он должен самостоятельно организовать буфер текста.
- Определено в:
-
getPartialSpanв интерфейсеTabableView - Параметры:
-
p0— начальное смещение в документе >= 0 -
p1— конечное смещение в документе >= p0 - Возвращает:
- размер >= 0
getStartOffset
public int getStartOffset()
- Переопределяет:
-
getStartOffsetв классеView - Возвращает:
- начальное смещение в модели
- См. также:
getEndOffset
public int getEndOffset()
- Переопределяет:
-
getEndOffsetв классеView - Возвращает:
- конечное смещение в модели
- См. также:
paint
getMinimumSpan
public float getMinimumSpan(int axis)
Эта реализация возвращает самую длинную неразрывную область представления в качестве минимального размера для View.X_AXIS.
- Переопределяет:
-
getMinimumSpanв классеView - Параметры:
-
axis— может иметь значениеView.X_AXISилиView.Y_AXIS - Возвращает:
- минимальный размер, в который можно визуализировать представление
- Вызывает исключение:
-
IllegalArgumentException— если параметрaxisимеет недопустимое значение - См. также:
getPreferredSpan
public float getPreferredSpan(int axis)
- Определено в:
-
getPreferredSpanв классеView - Параметры:
-
axis— может иметь значение View.X_AXIS или View.Y_AXIS - Возвращает:
- размер, в который представление желательно визуализировать >= 0. Обычно представлению предписывается визуализация в возвращенном размере, однако это не гарантируется. Родительское представление может изменить размер или разбить это представление.
getAlignment
public float getAlignment(int axis)
- Переопределяет:
-
getAlignmentв классеView - Параметры:
-
axis— может иметь значение View.X_AXIS или View.Y_AXIS - Возвращает:
- требуемое выравнивание. Это значение должно находиться в диапазоне от 0.0 до 1.0 включительно, где 0 означает выравнивание по началу координат, а 1.0 — выравнивание по точке на полном расстоянии от начала координат. Значение выравнивания 0.5 соответствует центру представления.
modelToView
public Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException
- Определено в:
-
modelToViewв классеView - Параметры:
-
pos— позиция для преобразования >= 0 -
a— выделенная область для отрисовки -
b—Position.Bias.ForwardилиPosition.Bias.Backward - Возвращает:
- ограничивающую рамку указанной позиции
- Вызывает исключение:
-
BadLocationException— если указанная позиция не соответствует допустимому месту в связанном документе - См. также:
viewToModel
public int viewToModel(float x, float y, Shape a, Position.Bias[] biasReturn)
- Определено в:
-
viewToModelв классеView - Параметры:
-
x— координата X >= 0 -
y— координата Y >= 0 -
a— выделенная область для отрисовки -
biasReturn—Position.Bias.ForwardилиPosition.Bias.Backwardвозвращается как нулевой элемент этого массива - Возвращает:
- позицию в модели, которая лучше всего соответствует указанной точке представления >= 0
- См. также:
getBreakWeight
public int getBreakWeight(int axis, float pos, float len)
breakView в процессе форматирования. Чем выше вес, тем привлекательнее место разрыва. Значение, равное или меньшее View.BadBreakWeight, не следует рассматривать как место разрыва. При значении, равном или большем View.ForcedBreakWeight, разрыв следует выполнить. Для оси Y_AXIS реализация передает вызов суперклассу. Для оси X_AXIS могут возвращаться следующие значения.
- View.ExcellentBreakWeight
- если перед предполагаемым местом разрыва есть пробельный символ.
- View.BadBreakWeight
- если предполагаемое место разрыва совпадает с начальным смещением.
- View.GoodBreakWeight
- если не выполняются другие условия.
- Переопределяет:
-
getBreakWeightв классеView - Параметры:
-
axis— может иметь значение View.X_AXIS или View.Y_AXIS -
pos— возможная позиция начала представления после разрыва >= 0. Может использоваться, например, для вычисления позиций табуляции. -
len— задает относительную длину от pos, на которой предполагается выполнить разрыв >= 0. - Возвращает:
- вес — значение между View.ForcedBreakWeight и View.BadBreakWeight.
- См. также:
breakView
public View breakView(int axis, int p0, float pos, float len)
- Переопределяет:
-
breakViewв классеView - Параметры:
-
axis— может иметь значение View.X_AXIS или View.Y_AXIS -
p0— позиция в модели, с которой должно начинаться отображение фрагмента >= 0. -
pos— позиция вдоль оси, которую должно занимать представление после разрыва >= 0. Может использоваться, например, для вычисления позиций табуляции. -
len— расстояние вдоль оси, на котором предполагается выполнить разрыв >= 0. - Возвращает:
- фрагмент представления, соответствующий указанному размеру, если представление допускает разбиение. Если представление не поддерживает разбиение, возвращается само представление.
- См. также:
createFragment
public View createFragment(int p0, int p1)
Это представление поддерживает разбиение на фрагменты. Реализация возвращает вложенный класс, который использует общее с этим представлением состояние и представляет только его часть.
- Переопределяет:
-
createFragmentв классеView - Параметры:
-
p0— начальное смещение >= 0. Оно должно быть не меньше начального смещения элемента и меньше конечного смещения элемента. -
p1— конечное смещение > p0. Оно должно быть не больше конечного смещения элемента и больше начального смещения элемента. - Возвращает:
- фрагмент представления или само представление, если оно не поддерживает разбиение на фрагменты
- См. также:
getNextVisualPositionFrom
public int getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet) throws BadLocationException
BadLocationException.- Переопределяет:
-
getNextVisualPositionFromв классеView - Параметры:
-
pos— позиция для преобразования -
b— смещение -
a— выделенная область для отрисовки -
direction— направление от текущей позиции, соответствующее клавишам со стрелками на клавиатуре. Это может быть SwingConstants.WEST, SwingConstants.EAST, SwingConstants.NORTH или SwingConstants.SOUTH. -
biasRet— возвращаемое смещение - Возвращает:
- позицию в модели, которая лучше всего соответствует следующей визуальной позиции.
- Вызывает исключение:
-
BadLocationException— если указанная позиция не является допустимой позицией в документе -
IllegalArgumentException— при недопустимом направлении
insertUpdate
public void insertUpdate(DocumentEvent e, Shape a, ViewFactory f)
- Переопределяет:
-
insertUpdateв классеView - Параметры:
-
e— сведения об изменении в связанном документе -
a— текущее выделение для представления -
f— фабрика для перестроения представления, если у него есть дочерние элементы - См. также:
removeUpdate
public void removeUpdate(DocumentEvent e, Shape a, ViewFactory f)
- Переопределяет:
-
removeUpdateв классеView - Параметры:
-
e— сведения об изменении в связанном документе -
a— текущее выделение для представления -
f— фабрика для перестроения представления, если у него есть дочерние элементы - См. также:
changedUpdate
public void changedUpdate(DocumentEvent e, Shape a, ViewFactory f)
- Переопределяет:
-
changedUpdateв классеView - Параметры:
-
e— сведения об изменении в связанном документе -
a— текущее выделение для представления -
f— фабрика для перестроения представления, если у него есть дочерние элементы - См. также:
© 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.