javax.swing.text

Класс ZoneView

java.lang. Объект

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

javax.swing.text. CompositeView

javax.swing.text. BoxView

javax.swing.text. ZoneView

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

SwingConstants

public class ZoneView
extends BoxView

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

ZoneView расширяет BoxView, чтобы обеспечить поле, которое реализует зоны для его дочерних элементов. Зоны являются специальными реализациями Представления (дочерние элементы экземпляра этого class), которые представляют только часть модели, за которую экземпляр ZoneView ответственен. Зоны не создают дочерние представления, пока попытка не предпринимается, чтобы вывести на экран их. Поле сформированное представление хорошо подходит для этого потому что:

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

Поведением значения по умолчанию управляют два свойства, maxZoneSize и maxZonesLoaded. Установка maxZoneSize к Целому числу. MAX_VALUE имел бы эффект того, чтобы заставлять только одну зону быть созданным. Это эффективно превратило бы представление в реализацию шаблона "декоратор". Установка maxZonesLoaded к значению Целого числа. MAX_VALUE заставил бы зоны никогда не разгружаться. Для простоты зоны создаются на границах, представленных дочерними элементами элемента, за который представление ответственно. Зоны могут быть любой реализацией Представления, но реализация по умолчанию основана на AsyncBoxView, который поддерживает довольно большие зоны эффективно.

С тех пор:

1.3

См. Также:

View

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

Поля, наследованные от 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

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

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

Конструктор и Описание
ZoneView(Element elem, int axis) Создает ZoneView.

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

Модификатор и Тип	Метод и Описание
protected View	createZone(int p0, int p1) Создайте представление, чтобы представить зону для данного диапазона в пределах модели (который должен быть в пределах диапазона этого, возражает ответственности).
int	getMaximumZoneSize() Получите текущий максимальный зональный размер.
int	getMaxZonesLoaded() Получите текущую установку числа зон, позволенных быть загруженными одновременно.
protected int	getViewIndexAtPosition(int pos) Возвращается дочернее представление индексируют представление данной позиции в модели.
void	insertUpdate(DocumentEvent changes, Shape a, ViewFactory f) Дает уведомление, что что-то было вставлено в документ в расположении, за которое это представление ответственно.
protected boolean	isZoneLoaded(View zone) Определите, находится ли зона в загруженном состоянии.
protected void	loadChildren(ViewFactory f) Загрузки все дочерние элементы, чтобы инициализировать представление.
void	removeUpdate(DocumentEvent changes, Shape a, ViewFactory f) Дает уведомление, что что-то было удалено из документа в расположении, за которое это представление ответственно.
void	setMaximumZoneSize(int size) Установите требуемый максимальный зональный размер.
void	setMaxZonesLoaded(int mzl) Устанавливает текущую установку числа зон, позволенных быть загруженными одновременно.
protected void	unloadZone(View zone) Разгрузитесь зона (Преобразуйте зону в ее состояние сохранения памяти).
protected boolean	updateChildren(DocumentEvent.ElementChange ec, DocumentEvent e, ViewFactory f) Поведение суперкласса попытается обновить дочерние представления, который не требуется в этом случае, так как дочерние элементы являются зонами и не непосредственно произведенные изменениями к связанному элементу.
protected void	zoneWasLoaded(View zone) Вызванный зоной, когда это загружается.

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

baselineLayout, baselineRequirements, calculateMajorAxisRequirements, calculateMinorAxisRequirements, childAllocation, flipEastAndWestAtEnds, forwardUpdate, getAlignment, getAxis, getChildAllocation, getHeight, getMaximumSpan, getMinimumSpan, getOffset, getPreferredSpan, getResizeWeight, getSpan, getViewAtPoint, getWidth, isAfter, isAllocationValid, isBefore, isLayoutValid, layout, layoutChanged, layoutMajorAxis, layoutMinorAxis, modelToView, paint, paintChild, preferenceChanged, replace, setAxis, setSize, viewToModel

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

getBottomInset, getInsideAllocation, getLeftInset, getNextEastWestVisualPositionFrom, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewAtPosition, getViewCount, getViewIndex, modelToView, setInsets, setParagraphInsets, setParent

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

append, breakView, changedUpdate, createFragment, forwardUpdateToView, getAttributes, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, isVisible, modelToView, remove, removeAll, updateLayout, viewToModel

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

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

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

ZoneView

public ZoneView(Element elem,
                int axis)

Создает ZoneView.

Параметры:

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

axis - любое Представление. X_AXIS или Представление. Y_AXIS

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

getMaximumZoneSize

public int getMaximumZoneSize()

Получите текущий максимальный зональный размер.

setMaximumZoneSize

public void setMaximumZoneSize(int size)

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

Параметры:

size - число символов зона может представить прежде, чем попытаться повредить зону в меньший размер.

getMaxZonesLoaded

public int getMaxZonesLoaded()

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

setMaxZonesLoaded

public void setMaxZonesLoaded(int mzl)

Устанавливает текущую установку числа зон, позволенных быть загруженными одновременно. Это бросит IllegalArgumentException если mzl меньше чем 1.

Параметры:

mzl - требуемое максимальное количество зон, которые будут активно загружены, должно быть больше чем 0

Броски:

IllegalArgumentException - если mzl < 1

zoneWasLoaded

protected void zoneWasLoaded(View zone)

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

Параметры:

zone - дочернее представление, которое было только загружено.

unloadZone

protected void unloadZone(View zone)

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

Параметры:

zone - дочернее представление, требуемое, чтобы быть установленным в разгруженное состояние.

isZoneLoaded

protected boolean isZoneLoaded(View zone)

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

createZone

protected View createZone(int p0,
                          int p1)

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

Параметры:

p0 - запуск требуемой зоны. Это должно быть> = getStartOffset () и < getEndOffset(). This value should also be < p1.

p1 - конец требуемой зоны. Это должно быть> getStartOffset () и <= getEndOffset(). This value should also be >p0.

loadChildren

protected void loadChildren(ViewFactory f)

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

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

loadChildren в class CompositeView

Параметры:

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

См. Также:

CompositeView.setParent(javax.swing.text.View)

getViewIndexAtPosition

protected int getViewIndexAtPosition(int pos)

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

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

getViewIndexAtPosition в class CompositeView

Параметры:

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

Возвраты:

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

updateChildren

protected boolean updateChildren(DocumentEvent.ElementChange ec,
                                 DocumentEvent e,
                                 ViewFactory f)

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

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

updateChildren в class View

Параметры:

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

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

f - фабрика, чтобы использовать, чтобы создать дочерние представления

Возвраты:

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

См. Также:

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)

insertUpdate

public void insertUpdate(DocumentEvent changes,
                         Shape a,
                         ViewFactory f)

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

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

insertUpdate в class View

Параметры:

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

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

f - фабрика, чтобы использовать, чтобы восстановить, если у представления есть дочерние элементы

См. Также:

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

removeUpdate

public void removeUpdate(DocumentEvent changes,
                         Shape a,
                         ViewFactory f)

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

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

removeUpdate в class View

Параметры:

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

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

f - фабрика, чтобы использовать, чтобы восстановить, если у представления есть дочерние элементы

См. Также:

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