AsyncBoxView (Java Platform SE 8 )

java.lang.Object
- javax.swing.text.View
- - javax.swing.text.AsyncBoxView

All Implemented Interfaces:

SwingConstants
```
public class AsyncBoxView
extends View
```
一个异步布局的框。这是有用的保持在不做任何布局的图形用户界面事件线程。布局是在子视图上的操作的粒度上完成的。在每个子视图访问一个布局的一部分（一个潜在的耗时操作）剩余的任务可以被放弃或一个新的更高优先级的任务（即服务一个同步请求或可见区域）可以采取。
虽然子视图正在访问关联的文档上的读锁，因此在访问该模型时，该模型是稳定的。

从以下版本开始：

一点三

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`class`	`AsyncBoxView.ChildLocator` 一个类来管理在局部区域中的子视图的有效位置，而正在改变局部区域的位置。
`class`	`AsyncBoxView.ChildState` 表示子视图的布局状态的记录。

Field Summary

Fields
Modifier and Type	Field and Description
`protected AsyncBoxView.ChildLocator`	`locator` 管理儿童的偏移的对象。

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
`AsyncBoxView(Element elem, int axis)` 构建一个异步布局的框视图。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`protected AsyncBoxView.ChildState`	`createChildState(View v)` 新的childstate记录被创建通过这种方法允许子类的扩展childstate记录做/持有更多
`protected void`	`flushRequirementChanges()` 发布向上的首选项向父视图的更改。
`float`	`getBottomInset()` 获取视图边缘的底部部分。
`Shape`	`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()` 取小轴（轴垂直于拼接轴）。
`int`	`getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)` 提供了一种方法来确定下一步的直观模型，一个可能的地方插入位置。
`float`	`getPreferredSpan(int axis)` 沿着一个轴确定该视图的首选跨度。
`float`	`getRightInset()` 获取视图边缘的右边部分。
`float`	`getTopInset()` 获得边缘的顶部周围的视图。
`View`	`getView(int n)` 得到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)` 沿小轴变化的要求。
`Shape`	`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)` 从视图坐标空间提供一个映射到模型的逻辑坐标空间。

Methods inherited from class javax.swing.text.View
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

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - locator
```
protected AsyncBoxView.ChildLocator locator
```
    管理儿童的偏移的对象。所有用于子位置管理的锁定都在这个对象上。
- Constructor Detail
  - 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()
```
    取小轴（轴垂直于拼接轴）。这将是有价值的或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。
    
    从以下版本开始：
    
    一点四
  - setEstimatedMajorSpan
```
protected void setEstimatedMajorSpan(boolean isEstimated)
```
    设置estimatedmajorspan性质是决定如果大跨度应视为估计。如果此属性为true，沿长轴的组量的值会改变要求沿长轴和增量的变化将被忽略，直到所有的孩子都被更新（这会导致属性自动设置为false）。如果属性是虚假的majorspan值将被认为是准确的和增量的变化将被添加到总为他们的计算。
    
    从以下版本开始：
    
    一点四
  - getEstimatedMajorSpan
```
protected boolean getEstimatedMajorSpan()
```
    是目前估计的主要跨度？
    
    从以下版本开始：
    
    一点四
  - 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对象做布局时，它已经完成了取孩子的意见新的偏好。通常情况下，这将是布局线程，但如果它试图立即更新一些东西（例如执行模型/视图转换），则可能是该用户界面线程的一个。
  - flushRequirementChanges
```
protected void flushRequirementChanges()
```
    发布向上的首选项向父视图的更改。这通常是由布局线程调用的。
  - replace
```
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 -更改元素这一观点负责（可能是null如果没有变化）。
    
    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 -视图的父，如果没有返回null
  - 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
  - paint
```
public void paint(Graphics g,
                  Shape alloc)
```
    使用给定的分配和渲染表面渲染视图。
    这是实施以确定是否需要渲染的区域（即不限地区）是最新的或不。如果最新的孩子们。如果不是最新的，一个任务，以建立所需的区域被放置在布局队列作为一个高优先级的任务。这使事件线程渲染如果准备搬家，推迟到以后如果没有准备好（因为涂料的要求可以改期）。
    
    Specified by:
    
    paint 方法重写，继承类 View
    
    参数
    
    g -绘制表面使用
    
    alloc -分配区域进行渲染
    
    另请参见：
    
    View.paint(java.awt.Graphics, java.awt.Shape)
  - getPreferredSpan
```
public float getPreferredSpan(int axis)
```
    沿着一个轴确定该视图的首选跨度。
    
    Specified by:
    
    getPreferredSpan 方法重写，继承类 View
    
    参数
    
    axis -可能是view.x_axis或view.y_axis
    
    结果
    
    跨度的视图将被渲染成> = 0。通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证。父可能会选择调整或打破视图。
    
    异常
    
    IllegalArgumentException -无效的轴型
    
    另请参见：
    
    View.getPreferredSpan(int)
  - getMinimumSpan
```
public float getMinimumSpan(int axis)
```
    沿着一个轴确定该视图的最小间距。
    
    重写：
    
    getMinimumSpan 方法重写，继承类 View
    
    参数
    
    axis -可能是view.x_axis或view.y_axis
    
    结果
    
    跨度的视图将被渲染成> = 0。通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证。父可能会选择调整或打破视图。
    
    异常
    
    IllegalArgumentException -无效的轴型
    
    另请参见：
    
    View.getPreferredSpan(int)
  - getMaximumSpan
```
public float getMaximumSpan(int axis)
```
    沿着一个轴确定该视图的最大跨度。
    
    重写：
    
    getMaximumSpan 方法重写，继承类 View
    
    参数
    
    axis -可能是view.x_axis或view.y_axis
    
    结果
    
    跨度的视图将被渲染成> = 0。通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证。父可能会选择调整或打破视图。
    
    异常
    
    IllegalArgumentException -无效的轴型
    
    另请参见：
    
    View.getPreferredSpan(int)
  - getViewCount
```
public int getViewCount()
```
    返回此视图中的视图数量。由于默认情况下是不是一个复合视图，这个返回0。
    
    重写：
    
    getViewCount 方法重写，继承类 View
    
    结果
    
    意见数> = 0
    
    另请参见：
    
    View.getViewCount()
  - getView
```
public View getView(int n)
```
    得到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
    
    从以下版本开始：
    
    一点三
  - modelToView
```
public Shape modelToView(int pos,
                         Shape a,
                         Position.Bias b)
                  throws BadLocationException
```
    提供从文档模型坐标空间到映射到它的视图的坐标空间的映射。
    
    Specified by:
    
    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参数将被填充在表明，给出更接近下一个字符的模型或模型中的前一字符。
    这将是由图形用户界面线程调用的，并在关联的模型上保持一个读锁。它实现了定位子视图并确定它在childlocator对象锁分配的，并呼吁儿童观viewtomodel在childstate对象锁来避免线程交互与布局。
    
    Specified by:
    
    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
```
    提供了一种方法来确定下一步的直观模型，一个可能的地方插入位置。一些视图可能是不可见的，它们可能不在模型中的相同的顺序中，或者它们只是可能不允许访问模型中的一些位置。此方法使指定在> = 0的范围内转换的位置。如果值为- 1，则将自动计算一个位置。如果该值小于1，将抛出的 BadLocationException。
    重写：
    
    getNextVisualPositionFrom 方法重写，继承类 View
    
    参数
    
    pos的位置转换
    
    a -分配区域进行渲染
    direction -这可以被认为是箭头键通常发现键盘上的当前位置的方向；这可能是下列之一：
    
    SwingConstants.WEST
    
    SwingConstants.EAST
    
    SwingConstants.NORTH
    
    SwingConstants.SOUTH
    biasRet -数组包含偏差检查
    
    结果
    
    最能代表下一个位置视觉位置的模型中的位置
    
    异常
    
    BadLocationException -给定的位置不在有效的文档位置
    
    IllegalArgumentException -如果 direction无效

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class AsyncBoxView

Nested Class Summary

Field Summary

Fields inherited from class javax.swing.text.View

Fields inherited from interface javax.swing.SwingConstants

构造方法摘要

方法摘要

Methods inherited from class javax.swing.text.View

Methods inherited from class java.lang.Object

Field Detail

locator

Constructor Detail

AsyncBoxView

方法详细信息

getMajorAxis

getMinorAxis

getTopInset

setTopInset

getBottomInset

setBottomInset

getLeftInset

setLeftInset

getRightInset

setRightInset

getInsetSpan

setEstimatedMajorSpan

getEstimatedMajorSpan

getChildState

getLayoutQueue

createChildState

majorRequirementChange

minorRequirementChange

flushRequirementChanges

replace

loadChildren

getViewIndexAtPosition

updateLayout

setParent

preferenceChanged

setSize

paint

getPreferredSpan

getMinimumSpan

getMaximumSpan

getViewCount

getView

getChildAllocation

getViewIndex

modelToView

viewToModel

getNextVisualPositionFrom