javax.swing.text

Класс CompositeView

java.lang. Объект

javax.swing.text. Представление

javax.swing.text. CompositeView

Все Реализованные Интерфейсы:

SwingConstants

Прямые Известные Подклассы:

BoxView

public abstract class CompositeView
extends View

CompositeView краткий обзор View реализация, которая управляет одним или более дочерними представлениями. (Отметьте это CompositeView предназначается для того, чтобы управлять относительно небольшими числами дочерних представлений.) CompositeView предназначается, чтобы использоваться в качестве начальной точки для View реализации, такой как BoxView, это будет содержать дочерний элемент Views. Подклассы, которые хотят управлять набором дочернего элемента Views должен использовать replace(int, int, javax.swing.text.View[]) метод. Как View вызывает replace во время DocumentListener уведомление, Вы обычно не должны будете непосредственно вызвать replace.

В то время как CompositeView не налагает политику расположения по ее дочернему элементу Views, это действительно учитывает inseting дочерний элемент Views это будет содержать. Вставки могут быть установлены также setInsets(short, short, short, short) или setParagraphInsets(javax.swing.text.AttributeSet).

В дополнение к абстрактным методам View, подклассы CompositeView должен будет переопределить:

• isBefore(int, int, java.awt.Rectangle) - Используемый, чтобы протестировать, если данный View расположение перед визуальным пространством CompositeView.
• isAfter(int, int, java.awt.Rectangle) - Используемый, чтобы протестировать, если данный View расположение после визуального пространства CompositeView.
• getViewAtPoint(int, int, java.awt.Rectangle) - Возвращает представление в данном визуальном расположении.
• childAllocation(int, java.awt.Rectangle) - Возвращает границы определенного дочернего элемента View. getChildAllocation вызовет childAllocation после offseting границы Insets CompositeView.

Полевая Сводка

Поля, наследованные от class javax.swing.text. Представление

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

Сводка конструктора

Конструкторы

Конструктор и Описание
CompositeView(Element elem) Конструкции a CompositeView для данного элемента.

Сводка метода

Модификатор и Тип	Метод и Описание
protected abstract void	childAllocation(int index, Rectangle a) Возвращает выделение для данного дочернего элемента.
protected boolean	flipEastAndWestAtEnds(int position, Position.Bias bias) Определяет, в котором направлении следующее представление кладет.
protected short	getBottomInset() Вставляли нижнюю часть.
Форма	getChildAllocation(int index, Shape a) Выбирает выделение для высказанного дочернего мнения, чтобы представить в.
protected Rectangle	getInsideAllocation(Shape a) Преобразовывает неизменное выделение, данное представлению к изменчивому выделению, которое представляет внутреннее выделение (то есть.
protected short	getLeftInset() Получает левую вставку.
protected int	getNextEastWestVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet) Возвращает следующую визуальную позицию для курсора, или в восточном или в западном направлении.
protected int	getNextNorthSouthVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet) Возвращает следующую визуальную позицию для курсора, или в северном или в южном направлении.
int	getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet) Обеспечивает способ определить следующее визуально представленное расположение модели, что можно было бы поместить каре.
protected short	getRightInset() Получает правильную вставку.
protected short	getTopInset() Получает главную вставку.
Представление	getView(int n) Возвращает энное представление в этом контейнере.
protected abstract View	getViewAtPoint(int x, int y, Rectangle alloc) Выбирает дочернее представление в данных координатах.
protected View	getViewAtPosition(int pos, Rectangle a) Выбирает дочернее представление, которое представляет данную позицию в модели.
int	getViewCount() Возвращает число дочерних представлений этого представления.
int	getViewIndex(int pos, Position.Bias b) Возвращается дочернее представление индексируют представление данной позиции в модели.
protected int	getViewIndexAtPosition(int pos) Выборки дочернее представление индексируют представление данной позиции в модели.
protected abstract boolean	isAfter(int x, int y, Rectangle alloc) Тесты, находится ли точка после прямоугольного диапазона.
protected abstract boolean	isBefore(int x, int y, Rectangle alloc) Тесты, находится ли точка перед прямоугольным диапазоном.
protected void	loadChildren(ViewFactory f) Загрузки все дочерние элементы, чтобы инициализировать представление.
Форма	modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a) Обеспечивает отображение от координатного пространства модели документа до координатного пространства представления, отображенного на это.
Форма	modelToView(int pos, Shape a, Position.Bias b) Обеспечивает отображение от координатного пространства модели документа до координатного пространства представления, отображенного на это.
void	replace(int offset, int length, View[] views) Дочерние представления замен.
protected void	setInsets(short top, short left, short bottom, short right) Устанавливает вставки для представления.
protected void	setParagraphInsets(AttributeSet attr) Устанавливает вставки от атрибутов абзаца, определенных в данных атрибутах.
void	setParent(View parent) Устанавливает родителя представления.
int	viewToModel(float x, float y, Shape a, Position.Bias[] bias) Обеспечивает отображение от координатного пространства представления до логического координатного пространства модели.

Методы, наследованные от class javax.swing.text. Представление

append, breakView, changedUpdate, createFragment, forwardUpdate, forwardUpdateToView, getAlignment, getAttributes, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getParent, getPreferredSpan, getResizeWeight, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, insertUpdate, isVisible, modelToView, paint, preferenceChanged, remove, removeAll, removeUpdate, setSize, updateChildren, updateLayout, viewToModel

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

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

Деталь конструктора

CompositeView

public CompositeView(Element elem)

Конструкции a CompositeView для данного элемента.

Параметры:

elem - элемент это представление ответственен за

Деталь метода

loadChildren

protected void loadChildren(ViewFactory f)

Загрузки все дочерние элементы, чтобы инициализировать представление. Это вызывают setParent(javax.swing.text.View) метод. Подклассы могут повторно реализовать это, чтобы инициализировать их дочерние представления другим способом. Реализация по умолчанию создает дочернее представление для каждого дочернего элемента.

Параметры:

f - фабрика представления

См. Также:

setParent(javax.swing.text.View)

setParent

public void setParent(View parent)

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

Переопределения:

setParent в class View

Параметры:

parent - родитель представления, null если ни один

getViewCount

public int getViewCount()

Возвращает число дочерних представлений этого представления.

Переопределения:

getViewCount в class View

Возвраты:

число представлений> = 0

См. Также:

getView(int)

getView

public View getView(int n)

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

Переопределения:

getView в class View

Параметры:

n - число требуемого представления,> = 0 && < getViewCount()

Возвраты:

представление в индексирует n

замена

public void replace(int offset,
                    int length,
                    View[] views)

Дочерние представления замен. Если нет никаких представлений, чтобы удалить, это действует как вставка. Если нет никаких представлений, чтобы добавить, что это действует как удаление. У удаляемых представлений будет родительский набор к null, и внутренняя ссылка на них удаленный так, чтобы они могли быть собраны "мусор".

Переопределения:

replace в class View

Параметры:

offset - начальное значение индекса в дочерний элемент просматривает, чтобы вставить новые представления;> = 0 и <= getViewCount

length - число существующего дочернего элемента просматривает, чтобы удалить; это должно быть значением> = 0 и <= (getViewCount() - offset)

views - дочерний элемент просматривает, чтобы добавить; это значение может быть null чтобы указать ни на какие дочерние элементы добавляются (полезный, чтобы удалить)

getChildAllocation

public Shape getChildAllocation(int index,
                                Shape a)

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

Переопределения:

getChildAllocation в class View

Параметры:

index - индексирование дочернего элемента,> = 0 && < getViewCount()

a - выделение к этому представлению

Возвраты:

выделение дочернему элементу

modelToView

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

Обеспечивает отображение от координатного пространства модели документа до координатного пространства представления, отображенного на это.

Определенный:

modelToView в class View

Параметры:

pos - позиция, чтобы преобразовать> = 0

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

b - значение смещения также Position.Bias.Forward или Position.Bias.Backward

Возвраты:

ограничивающий прямоугольник данной позиции

Броски:

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

См. Также:

View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)

modelToView

public Shape modelToView(int p0,
                         Position.Bias b0,
                         int p1,
                         Position.Bias b1,
                         Shape a)
                  throws BadLocationException

Обеспечивает отображение от координатного пространства модели документа до координатного пространства представления, отображенного на это.

Переопределения:

modelToView в class View

Параметры:

p0 - позиция, чтобы преобразовать> = 0

b0 - смещение к предыдущему символу или следующему символу, представленному p0, в случае, если позиция является границей двух представлений; также Position.Bias.Forward или Position.Bias.Backward

p1 - позиция, чтобы преобразовать> = 0

b1 - смещение к предыдущему символу или следующему символу, представленному p1, в случае, если позиция является границей двух представлений

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

Возвраты:

ограничивающий прямоугольник данной позиции возвращается

Броски:

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

IllegalArgumentException - для недопустимого параметра смещения

См. Также:

View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

viewToModel

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

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

Определенный:

viewToModel в class View

Параметры:

x - x координата расположения представления, чтобы преобразовать> = 0

y - y координата расположения представления, чтобы преобразовать> = 0

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

bias - также Position.Bias.Forward или Position.Bias.Backward

Возвраты:

расположение в пределах модели, которая лучше всего представляет данную точку в представлении> = 0

См. Также:

View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

getNextVisualPositionFrom

public int getNextVisualPositionFrom(int pos,
                                     Position.Bias b,
                                     Shape a,
                                     int direction,
                                     Position.Bias[] biasRet)
                              throws BadLocationException

Обеспечивает способ определить следующее визуально представленное расположение модели, что можно было бы поместить каре. Некоторые представления, возможно, не видимы, они не могли бы быть в том же самом порядке, найденном в модели, или они только не могли бы предоставить доступ к некоторым из расположений в модели. Это - метод удобства для getNextNorthSouthVisualPositionFrom(int, javax.swing.text.Position.Bias, java.awt.Shape, int, javax.swing.text.Position.Bias[]) и getNextEastWestVisualPositionFrom(int, javax.swing.text.Position.Bias, java.awt.Shape, int, javax.swing.text.Position.Bias[]).

Переопределения:

getNextVisualPositionFrom в class View

Параметры:

pos - позиция, чтобы преобразовать> = 0

b - значение смещения также Position.Bias.Forward или Position.Bias.Backward

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

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

• SwingConstants.WEST
• SwingConstants.EAST
• SwingConstants.NORTH
• SwingConstants.SOUTH

biasRet - массив, содержащий смещение, которое было проверено

Возвраты:

расположение в пределах модели, которая лучше всего представляет следующее расположение визуальная позиция

Броски:

BadLocationException

IllegalArgumentException - если direction недопустимо

getViewIndex

public int getViewIndex(int pos,
                        Position.Bias b)

Возвращается дочернее представление индексируют представление данной позиции в модели. Это реализуется, чтобы вызвать getViewIndexByPosition метод для обратной совместимости.

Переопределения:

getViewIndex в class View

Параметры:

pos - позиция> = 0

Возвраты:

индексируйте представления, представляющего данную позицию, или-1, если никакое представление не представляет ту позицию

С тех пор:

1.3

isBefore

protected abstract boolean isBefore(int x,
                                    int y,
                                    Rectangle alloc)

Тесты, находится ли точка перед прямоугольным диапазоном.

Параметры:

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

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

alloc - прямоугольник

Возвраты:

истина, если точка перед указанным диапазоном

isAfter

protected abstract boolean isAfter(int x,
                                   int y,
                                   Rectangle alloc)

Тесты, находится ли точка после прямоугольного диапазона.

Параметры:

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

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

alloc - прямоугольник

Возвраты:

истина, если точка после указанного диапазона

getViewAtPoint

protected abstract View getViewAtPoint(int x,
                                       int y,
                                       Rectangle alloc)

Выбирает дочернее представление в данных координатах.

Параметры:

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

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

alloc - выделение родителя на записи, которая должна быть изменена на выделение дочернего элемента на выходе

Возвраты:

дочернее представление

childAllocation

protected abstract void childAllocation(int index,
                                        Rectangle a)

Возвращает выделение для данного дочернего элемента.

Параметры:

index - индексирование дочернего элемента,> = 0 && < getViewCount()

a - выделение к внутренней части поля на записи, и выделение дочернего представления при индексировании на выходе.

getViewAtPosition

protected View getViewAtPosition(int pos,
                                 Rectangle a)

Выбирает дочернее представление, которое представляет данную позицию в модели. Это реализуется, чтобы выбрать представление в случае, где есть дочернее представление для каждого дочернего элемента.

Параметры:

pos - позиция> = 0

a - выделение к внутренней части поля на записи, и выделение представления, содержащего позицию на выходе

Возвраты:

представление, представляющее данную позицию, или null если нет того

getViewIndexAtPosition

protected int getViewIndexAtPosition(int pos)

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

Параметры:

pos - позиция> = 0

Возвраты:

индексируйте представления, представляющего данную позицию, или-1, если никакое представление не представляет ту позицию

getInsideAllocation

protected Rectangle getInsideAllocation(Shape a)

Преобразовывает неизменное выделение, данное представлению к изменчивому выделению, которое представляет внутреннее выделение (то есть границы данного выделения с вершиной, оставленной, нижняя часть, и правильные удаленные вставки. Ожидается, что возвращенное значение было бы далее видоизменено, чтобы представить выделение дочернему представлению. Это реализуется, чтобы снова использовать переменную экземпляра, таким образом, она избегает создавать чрезмерные Прямоугольники. Обычно результат вызова этого метода питался бы к childAllocation метод.

Параметры:

a - выделение, данное представлению

Возвраты:

выделение, которое представляет внутреннюю часть представления после полей, было все удалено; если данное выделение было null, возвращаемое значение null

setParagraphInsets

protected void setParagraphInsets(AttributeSet attr)

Устанавливает вставки от атрибутов абзаца, определенных в данных атрибутах.

Параметры:

attr - атрибуты

setInsets

protected void setInsets(short top,
                         short left,
                         short bottom,
                         short right)

Устанавливает вставки для представления.

Параметры:

top - главная вставка> = 0

left - левая вставка> = 0

bottom - нижняя вставка> = 0

right - правильная вставка> = 0

getLeftInset

protected short getLeftInset()

Получает левую вставку.

Возвраты:

вставка> = 0

getRightInset

protected short getRightInset()

Получает правильную вставку.

Возвраты:

вставка> = 0

getTopInset

protected short getTopInset()

Получает главную вставку.

Возвраты:

вставка> = 0

getBottomInset

protected short getBottomInset()

Вставляли нижнюю часть.

Возвраты:

вставка> = 0

getNextNorthSouthVisualPositionFrom

protected int getNextNorthSouthVisualPositionFrom(int pos,
                                                  Position.Bias b,
                                                  Shape a,
                                                  int direction,
                                                  Position.Bias[] biasRet)
                                           throws BadLocationException

Возвращает следующую визуальную позицию для курсора, или в северном или в южном направлении.

Параметры:

pos - позиция, чтобы преобразовать> = 0

b - значение смещения также Position.Bias.Forward или Position.Bias.Backward

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

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

• SwingConstants.NORTH
• SwingConstants.SOUTH

biasRet - массив, содержащий смещение, которое было проверено

Возвраты:

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

Броски:

BadLocationException

IllegalArgumentException - если direction недопустимо

См. Также:

getNextVisualPositionFrom(int, javax.swing.text.Position.Bias, java.awt.Shape, int, javax.swing.text.Position.Bias[])

getNextEastWestVisualPositionFrom

protected int getNextEastWestVisualPositionFrom(int pos,
                                                Position.Bias b,
                                                Shape a,
                                                int direction,
                                                Position.Bias[] biasRet)
                                         throws BadLocationException

Возвращает следующую визуальную позицию для курсора, или в восточном или в западном направлении.

Параметры:

pos - позиция, чтобы преобразовать> = 0

b - значение смещения также Position.Bias.Forward или Position.Bias.Backward

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

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

• SwingConstants.WEST
• SwingConstants.EAST

biasRet - массив, содержащий смещение, которое было проверено

Возвраты:

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

Броски:

BadLocationException

IllegalArgumentException - если direction недопустимо

См. Также:

getNextVisualPositionFrom(int, javax.swing.text.Position.Bias, java.awt.Shape, int, javax.swing.text.Position.Bias[])

flipEastAndWestAtEnds

protected boolean flipEastAndWestAtEnds(int position,
                                        Position.Bias bias)

Определяет, в котором направлении следующее представление кладет. Рассмотрите View в индексируют n. Обычно Views являются layed из слева направо, так, чтобы View на ВОСТОК будет в, индексируют n + 1, и View на ЗАПАД будет в, индексируют n - 1. В определенных ситуациях, такой как с двунаправленным текстом, возможно что View на ВОСТОК не в, индексируют n + 1, а скорее в индексируют n - 1, или что View на ЗАПАД не в, индексируют n - 1, но индексируют n + 1. В этом случае этот метод возвратил бы true, указывая Views являются layed в порядке убывания.

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

Параметры:

position - позиция в модель

bias - также Position.Bias.Forward или Position.Bias.Backward

Возвраты:

ложь