javax.swing.text

Class ZoneView

java.lang.Object

javax.swing.text.View

javax.swing.text.CompositeView

javax.swing.text.BoxView

javax.swing.text.ZoneView

All Implemented Interfaces:

SwingConstants

public class ZoneView
extends BoxView

zoneview是视图的实现创造区，孩子的意见是不产生或储存到他们需要显示或模型/视图转换。这使大量减少内存消耗的情况下，所代表的模型是非常大的，通过构建视图对象只为该区域正在积极查看/编辑。孩子的大小可以在某种程度上估计，或异步计算，只有被保存的结果。

zoneview延伸boxview提供箱实现带孩子。该区特殊的视图的实现（这个类的一个实例的孩子），只代表ZoneView的模型实例负责一部分。区域不要创建子视图，直到尝试显示它们为止。一个框形的视图非常适合这个，因为：

• 盒是一个大量使用的视图，并有一个框，提供这种行为提供了大量的机会，插入到视图层次结构的视图工厂。
• 盒子是在一个方向上的，所以很容易将它们划分成一个可靠的方式。
• 盒通常与模型有一个简单的关系（即它们创建直接表示子元素的子视图）。
• 盒是更容易估计比一些其他形状的大小。

默认行为是由两个属性控制，maxzonesize和maxzonesloaded。设置maxzonesize到integer.max_value会导致只有一个区要创建的效果。这将有效地把视野引入装饰者模式的实现。设置一个值maxzonesloaded integer.max_value会造成区永远卸。为简单起见，区域被创建在由元素的子元素表示的边界上，视图负责。区域可以实现任何观点，但默认的实现是基于AsyncBoxView支持相当大的区域有效。

从以下版本开始：

一点三

另请参见：

View

Field Summary

Fields inherited from class javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Fields inherited from interface 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

构造方法摘要

构造方法

Constructor and Description
ZoneView(Element elem, int axis) 构建了一个zoneview。

方法摘要

Modifier and Type	Method and Description
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) 当它被加载时调用一个区域。

Methods inherited from 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

Methods inherited from class javax.swing.text.CompositeView

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

Methods inherited from class javax.swing.text.View

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ZoneView

public ZoneView(Element elem,
                int axis)

构建了一个zoneview。

参数

elem -元这一观点负责

axis - view.x_axis或view.y_axis

方法详细信息

getMaximumZoneSize

public int getMaximumZoneSize()

获取当前最大区域大小。

setMaximumZoneSize

public void setMaximumZoneSize(int size)

设置所需的最大区域大小。如果一个子视图大于这个大小，则一个区域可能会比这个大小更大，因为在子视图边界上形成区域。

参数

size -区的字符数可能是在试图打破区成较小的尺寸。

getMaxZonesLoaded

public int getMaxZonesLoaded()

获取允许在同一时间加载的区域的数量的当前设置。

setMaxZonesLoaded

public void setMaxZonesLoaded(int mzl)

设置允许在同一时间加载的区域的数量的当前设置。如果这样会 mzl小于1抛出一个 IllegalArgumentException。

参数

mzl -区域所需的最大数量是积极加载，必须大于0

异常

IllegalArgumentException -如果 mzl是＜1

zoneWasLoaded

protected void zoneWasLoaded(View zone)

当它被加载时调用一个区域。当一个尝试显示或执行一个处于卸载状态的区域的模型/视图转换时，会发生这种情况。这是实现检查，如果区域的最大数量，并卸载最古老的区域，如果是这样。

参数

zone -孩子的观点，只是装。

unloadZone

protected void unloadZone(View zone)

卸载一个区域（将区域转换为它的内存保存状态）。该区域预计将代表元素的子元素的子元素的一个子集，这个视图是负责。因此，默认的实现是简单的删除所有的孩子。

参数

zone -孩子的观点需要被设置为空载状态。

isZoneLoaded

protected boolean isZoneLoaded(View zone)

确定一个区域是否处于加载状态。该区域预计将代表元素的子元素的子元素的一个子集，这个视图是负责。因此，默认的实现是返回真实的，如果视图有孩子。

createZone

protected View createZone(int p0,
                          int p1)

创建一个视图来表示给定范围内的给定范围内的模型（该模型应该在这个对象的范围内）。这就是所谓的区域管理逻辑，创建新的区域。子类可以通过改变这种方法为区域提供不同的实现。

参数

p0 -所需的启动区。这应该是getstartoffset() >>和<< getendoffset() =。此值应＜P1。

p1 -期望区结束。这应该是getstartoffset()和<= getendoffset() >。这个值也应大于P0。

loadChildren

protected void loadChildren(ViewFactory f)

加载所有的孩子来初始化视图。这是所谓的 setParent方法。这是重新实现不加载任何孩子直接（因为它们是由区创建）。此方法创建区域的初始组。区域并不是真正的填充，但是，直到尝试显示它们或做模型/视图坐标转换。

重写：

loadChildren 方法重写，继承类 CompositeView

参数

f -看厂

另请参见：

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

getViewIndexAtPosition

protected int getViewIndexAtPosition(int pos)

返回表示模型中给定位置的子视图索引。

重写：

getViewIndexAtPosition 方法重写，继承类 CompositeView

参数

pos --位置> = 0

结果

表示给定位置的视图的索引，或-如果没有视图表示该位置，或- 1

updateChildren

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

父类的行为将尝试更新孩子的意见，是不是在这种情况下所需要的，因为孩子们都带不直接影响到相关的元素的变化。这是重新实现，什么都不做，返回false。

重写：

updateChildren 方法重写，继承类 View

参数

ec的变化信息的元素这一观点负责。这不应该是 null如果这个方法被调用

e -从相关文档的变更信息

f -工厂用建立的子视图

结果

是否子视图表示元素的子元素的子元素，此视图负责。一些视图创建表示它们负责的元素的一部分的儿童，并返回错误的。此信息用于确定是否将添加的元素的范围中的视图转发给或不转发给

另请参见：

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 方法重写，继承类 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 方法重写，继承类 View

参数

changes -从相关文档的变更信息

a -视图的当前配置

f -工厂用重建如果视图有孩子

另请参见：

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