javax.swing.text

Класс AsyncBoxView

java.lang. Объект

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

javax.swing.text. AsyncBoxView

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

SwingConstants

public class AsyncBoxView
extends View

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

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

С тех пор:

1.3

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
class	AsyncBoxView. ChildLocator Класс, чтобы управлять эффективной позицией дочернего элемента просматривает в локализованной области, в то время как изменения производятся вокруг локализованной области.
class	AsyncBoxView. ChildState Запись, представляющая состояние расположения дочернего представления.

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

Поля

Модификатор и Тип	Поле и Описание
protected AsyncBoxView.ChildLocator	локатор Объект, который управляет смещениями дочерних элементов.

Поля 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

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

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

Конструктор и Описание
AsyncBoxView(Element elem, int axis) Создайте представление поля, которое делает асинхронное расположение.

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

Методы

Модификатор и Тип	Метод и Описание
protected AsyncBoxView.ChildState	createChildState(View v) Новые записи ChildState создаются через этот метод, чтобы позволить подклассам расширение записей ChildState, чтобы/содержать больше
protected void	flushRequirementChanges() Опубликуйте изменения в предпочтении вверх к родительскому представлению.
float	getBottomInset() Получите нижнюю часть поля вокруг представления.
Форма	getChildAllocation(int index, Shape a) Выбирает выделение для высказанного дочернего мнения.
protected AsyncBoxView.ChildState	getChildState(int index) Выберите объект, представляющий состояние расположения дочернего элемента по данному индексу.
protected boolean	getEstimatedMajorSpan() Главный промежуток в настоящий момент оценивается?
protected float	getInsetSpan(int axis) Выберите промежуток вдоль оси, которая приводится в рабочее состояние вставками.
protected LayoutQueue	getLayoutQueue() Выберите очередь, чтобы использовать для расположения.
float	getLeftInset() Получите левую часть поля вокруг представления.
int	getMajorAxis() Выберите главную ось (ось, дочерние элементы размещаются рядом вперед).
float	getMaximumSpan(int axis) Определяет максимальный промежуток для этого представления вдоль оси.
float	getMinimumSpan(int axis) Определяет минимальный промежуток для этого представления вдоль оси.
int	getMinorAxis() Выберите незначительную ось (ось orthoginal к размещенной рядом оси).
int	getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet) Обеспечивает способ определить следующее визуально представленное расположение модели, что можно было бы поместить каре.
float	getPreferredSpan(int axis) Определяет привилегированный промежуток для этого представления вдоль оси.
float	getRightInset() Получите правильную часть поля вокруг представления.
float	getTopInset() Получите верхнюю часть поля вокруг представления.
Представление	getView(int n) Получает энное дочернее представление.
int	getViewCount() Возвращает число представлений в этом представлении.
int	getViewIndex(int pos, Position.Bias b) Возвращает дочерний индекс представления, представляющий данную позицию в модели.
protected int	getViewIndexAtPosition(int pos, Position.Bias b) Выбирает дочерний индекс представления, представляющий данную позицию в модели.
protected void	loadChildren(ViewFactory f) Загрузки все дочерние элементы, чтобы инициализировать представление.
protected void	majorRequirementChange(AsyncBoxView.ChildState cs, float delta) Требования изменились вдоль главной оси.
protected void	minorRequirementChange(AsyncBoxView.ChildState cs) Требования изменились вдоль незначительной оси.
Форма	modelToView(int pos, Shape a, Position.Bias b) Обеспечивает отображение от координатного пространства модели документа до координатного пространства представления, отображенного на это.
void	paint(Graphics g, Shape alloc) Представьте представление, используя данное выделение и представляя поверхность.
void	preferenceChanged(View child, boolean width, boolean height) Дочерние представления могут вызвать это на родителе, чтобы указать, что предпочтение изменилось и должно быть пересмотрено для расположения.
void	replace(int offset, int length, View[] views) Вызывает суперкласс, чтобы обновить дочерние представления, и обновляет записи состояния для дочерних элементов.
void	setBottomInset(float i) Установите нижнюю часть поля вокруг представления.
protected void	setEstimatedMajorSpan(boolean isEstimated) Установите estimatedMajorSpan свойство, которое определяет, должен ли главный промежуток быть обработан как оцениваемый.
void	setLeftInset(float i) Установите левую часть поля вокруг представления.
void	setParent(View parent) Устанавливает родителя представления.
void	setRightInset(float i) Установите правильную часть поля вокруг представления.
void	setSize(float width, float height) Устанавливает размер представления.
void	setTopInset(float i) Установите верхнюю часть поля вокруг представления.
protected void	updateLayout(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a) Обновите расположение в ответ на получение уведомления об изменении от модели.
int	viewToModel(float x, float y, Shape a, Position.Bias[] biasReturn) Обеспечивает отображение от координатного пространства представления до логического координатного пространства модели.

Методы javax.swing.text унаследованный от класса. Представление

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

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

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

Полевая Деталь

локатор

protected AsyncBoxView.ChildLocator locator

Объект, который управляет смещениями дочерних элементов. Вся блокировка для управления дочерними расположениями находится на этом объекте.

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

AsyncBoxView

public AsyncBoxView(Element elem,
            int axis)

Создайте представление поля, которое делает асинхронное расположение.

Параметры:

elem - элемент модели, чтобы представить

axis - ось к мозаике вперед. Это может быть или X_AXIS или Y_AXIS.

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

getMajorAxis

public int getMajorAxis()

Выберите главную ось (ось, дочерние элементы размещаются рядом вперед). У этого будет значение или X_AXIS или Y_AXIS.

getMinorAxis

public int getMinorAxis()

Выберите незначительную ось (ось orthoginal к размещенной рядом оси). У этого будет значение или X_AXIS или Y_AXIS.

getTopInset

public float getTopInset()

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

setTopInset

public void setTopInset(float i)

Установите верхнюю часть поля вокруг представления.

Параметры:

i - значение вставки

getBottomInset

public float getBottomInset()

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

setBottomInset

public void setBottomInset(float i)

Установите нижнюю часть поля вокруг представления.

Параметры:

i - значение вставки

getLeftInset

public float getLeftInset()

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

setLeftInset

public void setLeftInset(float i)

Установите левую часть поля вокруг представления.

Параметры:

i - значение вставки

getRightInset

public float getRightInset()

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

setRightInset

public void setRightInset(float i)

Установите правильную часть поля вокруг представления.

Параметры:

i - значение вставки

getInsetSpan

protected float getInsetSpan(int axis)

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

Параметры:

axis - ось, чтобы определить общее количество вставляет вперед, или X_AXIS или Y_AXIS.

С тех пор:

1.4

setEstimatedMajorSpan

protected void setEstimatedMajorSpan(boolean isEstimated)

Установите estimatedMajorSpan свойство, которое определяет, должен ли главный промежуток быть обработан как оцениваемый. Если это свойство будет истиной, то значение setSize вдоль главной оси изменит требования вдоль главной оси, и инкрементные изменения будут проигнорированы, пока все дочерние элементы не были обновлены (который заставит свойство автоматически быть установленным в ложь). Если свойство будет ложью, то значение majorSpan, как будут полагать, будет точно, и инкрементные изменения будут добавлены в общее количество, поскольку они вычисляются.

С тех пор:

1.4

getEstimatedMajorSpan

protected boolean getEstimatedMajorSpan()

Главный промежуток в настоящий момент оценивается?

С тех пор:

1.4

getChildState

protected AsyncBoxView.ChildState getChildState(int index)

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

Параметры:

index - дочерний индекс. Это должно быть значением> = 0 и < getViewCount().

getLayoutQueue

protected LayoutQueue getLayoutQueue()

Выберите очередь, чтобы использовать для расположения.

createChildState

protected AsyncBoxView.ChildState createChildState(View v)

Новые записи ChildState создаются через этот метод, чтобы позволить подклассам расширение записей ChildState, чтобы/содержать больше

majorRequirementChange

protected void majorRequirementChange(AsyncBoxView.ChildState cs,
                          float delta)

Требования изменились вдоль главной оси. Это вызывает расположение выполнения потока для данного объекта ChildState, когда это завершилось, выборка дочернего элемента просматривает новое предпочтение. Обычно это было бы потоком расположения, но могло бы быть потоком события, если это пытается обновить что-то сразу (например, выполнить преобразование модели/представления).

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

minorRequirementChange

protected void minorRequirementChange(AsyncBoxView.ChildState cs)

Требования изменились вдоль незначительной оси. Это вызывает расположение выполнения потока для данного объекта ChildState, когда это завершилось, выборка дочернего элемента просматривает новое предпочтение. Обычно это было бы потоком расположения, но могло бы быть потоком GUI, если это пытается обновить что-то сразу (например, выполнить преобразование модели/представления).

flushRequirementChanges

protected void flushRequirementChanges()

Опубликуйте изменения в предпочтении вверх к родительскому представлению. Это обычно вызывает поток расположения.

замена

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

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

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

replace в классе View

Параметры:

offset - начальное смещение в дочерние представления> = 0

length - число существующих представлений, чтобы заменить> = 0

views - дочерний элемент просматривает, чтобы вставить

loadChildren

protected void loadChildren(ViewFactory f)

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

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

Параметры:

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

См. Также:

setParent(javax.swing.text.View)

getViewIndexAtPosition

protected int getViewIndexAtPosition(int pos,
                         Position.Bias b)

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

Параметры:

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

Возвраты:

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

updateLayout

protected void updateLayout(DocumentEvent.ElementChange ec,
                DocumentEvent e,
                Shape a)

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

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

updateLayout в классе View

Параметры:

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

e - информация об изменении из ассоциированного документа

a - текущее выделение представления

См. Также:

View.insertUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory), View.removeUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory), View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

setParent

public void setParent(View parent)

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

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

setParent в классе View

Параметры:

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

preferenceChanged

public void preferenceChanged(View child,
                     boolean width,
                     boolean height)

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

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

preferenceChanged в классе View

Параметры:

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

width - истина, если предпочтение ширины изменилось

height - истина, если предпочтение высоты изменилось

См. Также:

JComponent.revalidate()

setSize

public void setSize(float width,
           float height)

Устанавливает размер представления. Это должно вызвать расположение представления если кэши представления любая информация о расположении.

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

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

setSize в классе View

Параметры:

width - ширина> = 0

height - высота> = 0

краска

public void paint(Graphics g,
         Shape alloc)

Представьте представление, используя данное выделение и представляя поверхность.

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

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

paint в классе View

Параметры:

g - поверхность рендеринга, чтобы использовать

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

См. Также:

View.paint(java.awt.Graphics, java.awt.Shape)

getPreferredSpan

public float getPreferredSpan(int axis)

Определяет привилегированный промежуток для этого представления вдоль оси.

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

getPreferredSpan в классе View

Параметры:

axis - может быть любой Представление. X_AXIS или Представление. Y_AXIS

Возвраты:

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

Броски:

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

См. Также:

View.getPreferredSpan(int)

getMinimumSpan

public float getMinimumSpan(int axis)

Определяет минимальный промежуток для этого представления вдоль оси.

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

getMinimumSpan в классе View

Параметры:

axis - может быть любой Представление. X_AXIS или Представление. Y_AXIS

Возвраты:

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

Броски:

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

См. Также:

View.getPreferredSpan(int)

getMaximumSpan

public float getMaximumSpan(int axis)

Определяет максимальный промежуток для этого представления вдоль оси.

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

getMaximumSpan в классе View

Параметры:

axis - может быть любой Представление. X_AXIS или Представление. Y_AXIS

Возвраты:

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

Броски:

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

См. Также:

View.getPreferredSpan(int)

getViewCount

public int getViewCount()

Возвращает число представлений в этом представлении. Так как значение по умолчанию не должно быть составным представлением, которое это возвращает 0.

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

getViewCount в классе View

Возвраты:

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

См. Также:

View.getViewCount()

getView

public View getView(int n)

Получает энное дочернее представление. С тех пор нет никаких дочерних элементов по умолчанию, это возвращает нуль.

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

getView в классе View

Параметры:

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

Возвраты:

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

getChildAllocation

public Shape getChildAllocation(int index,
                       Shape a)

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

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

getChildAllocation в классе View

Параметры:

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

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

Возвраты:

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

getViewIndex

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

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

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

getViewIndex в классе View

Параметры:

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

Возвраты:

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

С тех пор:

1.3

modelToView

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

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

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

modelToView в классе View

Параметры:

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

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

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

Возвраты:

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

Броски:

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[] biasReturn)

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

Это, как ожидают, вызовет поток GUI, содержа блокировку чтения на связанной модели. Это реализуется, чтобы определить местоположение дочернего представления и решить, что это - выделение с блокировкой на объекте ChildLocator, и вызывать viewToModel на дочернем представлении с блокировкой на объекте ChildState избежать взаимодействия с потоком расположения.

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

viewToModel в классе View

Параметры:

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

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

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

Возвраты:

расположение в пределах модели, которая лучше всего представляет данную точку в представлении> = 0. biasReturn параметр будет заполнен в указать, что данная точка ближе к следующему символу в модели или предыдущему символу в модели.

getNextVisualPositionFrom

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

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

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

getNextVisualPositionFrom в классе View

Параметры:

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

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

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

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

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

Возвраты:

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

Броски:

BadLocationException

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