Класс ComponentView

java.lang.Object

javax.swing.text.View

javax.swing.text.ComponentView

Все реализуемые интерфейсы:: SwingConstants

Непосредственные известные подклассы:: FormView, ObjectView

public class ComponentView extends View

Декоратор компонента, реализующий интерфейс представления. Весь элемент используется для представления компонента. Это служит шлюзом от реализаций представления, отображающих только данные, к интерактивным лёгким компонентам (т.е. позволяет встраивать компоненты в иерархию представления).

Компонент размещается относительно базовой линии текста в соответствии со значением, возвращаемым Component.getAlignmentY. Для компонентов Swing это значение удобно задавать с помощью метода JComponent.setAlignmentY. Например, задание значения 0.75 приведет к тому, что 75 процентов компонента будут находиться над базовой линией, а 25 процентов — под ней.

Этот класс реализован для выполнения дополнительной работы, необходимой для корректной работы в многопоточной среде (например, при асинхронном уведомлении о изменениях модели), обеспечивая, что все обращения к компоненту выполняются в потоке обработки событий.

Использованный компонент определяется значением, возвращаемым методом createComponent. По умолчанию этот метод возвращает компонент, хранящийся в качестве атрибута элемента (вызывая StyleConstants.getComponent). Ограничение этого поведения заключается в том, что компонент не может использоваться более чем одним текстовым компонентом (т. е. с общей моделью). Подклассы могут устранить это ограничение, реализовав createComponent для фактического создания компонента на основе некоторого вида спецификации, содержащейся в атрибутах. Класс ObjectView в пакете html является примером реализации ComponentView, которая поддерживает несколько представлений компонента общей модели.

Краткое описание полей

Поля, объявленные в классе javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Поля, объявленные в интерфейсе javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

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

Конструктор	Описание
`ComponentView(Element elem)`	Создаёт новый объект ComponentView.

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

Модификатор и тип	Метод	Описание
`protected Component`	`createComponent()`	Создаёт компонент, связанный с данным представлением.
`float`	`getAlignment(int axis)`	Определяет желаемое выравнивание данного представления по оси.
`final Component`	`getComponent()`	Извлекает компонент, связанный с представлением.
`float`	`getMaximumSpan(int axis)`	Определяет максимальное значение размаха для данного представления по оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальное значение размаха для данного представления по оси.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительное значение размаха для данного представления по оси.
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Предоставляет отображение из координатного пространства модели в координатное пространство представления.
`void`	`paint(Graphics g, Shape a)`	Реальное поведение рисования происходит естественным образом из связи компонента с его родительским контейнером (тем же контейнером, который содержит это представление).
`void`	`setParent(View p)`	Устанавливает родителя для дочернего представления.
`int`	`viewToModel(float x, float y, Shape a, Position.Bias[] bias)`	Предоставляет отображение из координатного пространства представления в логическое координатное пространство модели.

Методы, объявленные в классе javax.swing.text.View

append, breakView, changedUpdate, createFragment, forwardUpdate, forwardUpdateToView, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, setSize, updateChildren, updateLayout, viewToModel

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

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

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

ComponentView

public ComponentView(Element elem)

Создаёт новый объект ComponentView.

Параметры:: elem - элемент для декорирования

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

createComponent

protected Component createComponent()

Создаёт компонент, связанный с этим представлением. Вызывается, когда необходимо создать новый компонент. Это может произойти при вызове setParent или в результате уведомления об изменении атрибутов.

Возвращает:: компонент, связанный с этим представлением

getComponent

public final Component getComponent()

Возвращает компонент, связанный с представлением.

Возвращает:: компонент, связанный с представлением

paint

public void paint(Graphics g, Shape a)

Действительное поведение отрисовки происходит естественным образом из связи компонента с его контейнером-родителем (тем же контейнером, что и это представление). Эта функция реализована как пустая.

Определено в:

paint в классе View

Параметры:

g - контекст графики

a - фигура

См. также:

getPreferredSpan

public float getPreferredSpan(int axis)

Определяет предпочтительный размер этого представления вдоль оси. Реализовано так, чтобы возвращать значение, возвращаемое Component.getPreferredSize вдоль интересующей оси.

Определено в:: getPreferredSpan в классе View
Параметры:: axis - может быть либо View.X_AXIS, либо View.Y_AXIS
Возвращает:: размер, который представление хочет занять, >=0. Обычно представлению говорят отображаться в этом размере, но это не гарантировано. Родитель может изменить размер или разбить представление.
Исключение:: IllegalArgumentException - для неверной оси

getMinimumSpan

public float getMinimumSpan(int axis)

Определяет минимальный размер этого представления вдоль оси. Реализовано так, чтобы возвращать значение, возвращаемое Component.getMinimumSize вдоль интересующей оси.

Переопределяет:

getMinimumSpan в классе View

Параметры:

axis - может быть либо View.X_AXIS, либо View.Y_AXIS

Возвращает:

размер, который представление хочет занять, >=0. Обычно представлению говорят отображаться в этом размере, но это не гарантировано. Родитель может изменить размер или разбить представление.

Исключение:

IllegalArgumentException - для неверной оси

См. также:

getMaximumSpan

public float getMaximumSpan(int axis)

Определяет максимальный размер этого представления вдоль оси. Реализовано так, чтобы возвращать значение, возвращаемое Component.getMaximumSize вдоль интересующей оси.

Переопределяет:

getMaximumSpan в классе View

Параметры:

axis - может быть либо View.X_AXIS, либо View.Y_AXIS

Возвращает:

Исключение:

IllegalArgumentException - для неверной оси

См. также:

getAlignment

public float getAlignment(int axis)

Определяет желаемое выравнивание этого представления вдоль оси. Реализовано так, чтобы возвращать выравнивание вложенного компонента.

Переопределяет:: getAlignment в классе View
Параметры:: axis - может быть либо View.X_AXIS, либо View.Y_AXIS
Возвращает:: желаемое выравнивание. Должно быть значением от 0.0 до 1.0, где 0 обозначает выравнивание по началу, а 1.0 — по концу; 0.5 — центр представления.

setParent

public void setParent(View p)

Устанавливает родительское представление для дочернего представления. Родитель вызывает это на дочернем представлении, чтобы указать, кто является родителем, предоставляя представлению доступ к контейнеру. Выполняется поведение предка, за которым следует вызов createComponent, если родительское представление не null и компонент ещё не создан. Родитель вложенного компонента затем устанавливается в значение, возвращаемое getContainer. Если родительское представление null, это представление очищается, и компонент удаляется из своего родителя.

Изменение иерархии компонентов затронет блокировку компонента, что является единственной небезопасной частью иерархии представлений. Поэтому данная функциональность выполняется немедленно, если она находится в потоке событий, или помещается в очередь событий, если она вызывается из другого потока (уведомление об изменении из асинхронного обновления).

Переопределяет:: setParent в классе View
Параметры:: p - родитель

modelToView

public Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException

Предоставляет отображение из координатного пространства модели в пространство представления.

Определено в:

modelToView в классе View

Параметры:

pos - позиция для преобразования >=0

a - область выделения для отрисовки

b - смещение в сторону предыдущего или следующего символа, в случае если позиция является границей двух представлений; b будет иметь одно из этих значений:

Position.Bias.Forward
Position.Bias.Backward

Возвращает:

возвращается область расположения заданной позиции

Исключение:

BadLocationException - если заданная позиция не представляет допустимое расположение в связанном документе

См. также:

viewToModel

public int viewToModel(float x, float y, Shape a, Position.Bias[] bias)

Предоставляет отображение из координатного пространства представления в логическое координатное пространство модели.

Определено в:

viewToModel в классе View

Параметры:

x - координата X >=0

y - координата Y >=0

a - область выделения для отрисовки

bias - возвращаемое смещение

Возвращает:

местоположение в модели, наиболее точно представляющее заданную точку в представлении

См. также:

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/text/ComponentView.html