javax.swing.text
类 ParagraphView

java.lang.Object
  javax.swing.text.View
      javax.swing.text.CompositeView
          javax.swing.text.BoxView
              javax.swing.text.FlowView
                  javax.swing.text.ParagraphView

所有已实现的接口：

SwingConstants, TabExpander

直接已知子类：

ParagraphView

public class ParagraphView
extends FlowView
implements TabExpander

存在简单换行的段落的视图，其支持多种字体、颜色、组件、图标等。它基本上是周围有空白的纵向框。该框的内容是一组行，这些行是特殊的横向框。此视图创建表示段落元素的子元素的视图集合。如果这些视图合适，则可将其中的每个视图直接放到行中；否则，将调用 breakView 方法尝试将视图切割成合适的片段。

另请参见：

View

firstLineIndent

protected int firstLineIndent

相对于左边的 inset 进行的第一行的缩进。

ParagraphView

public ParagraphView(Element elem)

创建给定元素的 ParagraphView。

参数：

elem - 此视图负责的元素

setJustification

protected void setJustification(int j)

设置对齐方式的类型。

参数：

j - 为下列值之一：

• StyleConstants.ALIGN_LEFT
• StyleConstants.ALIGN_CENTER
• StyleConstants.ALIGN_RIGHT

setLineSpacing

protected void setLineSpacing(float ls)

设置行间距。

参数：

ls - 该值为行高的因子

setFirstLineIndent

protected void setFirstLineIndent(float fi)

设置第一行的行缩进量。

参数：

fi - 以磅 (point) 为单位的值

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()

从属性集设置缓存的属性。

getLayoutViewCount

protected int getLayoutViewCount()

返回此视图负责的视图数。段落的子视图是已用于安排表示子元素的 View 片段的行。这是平铺在两个维数之间的视图数，此数应等于此视图负责的元素的子元素数。

返回：

此 ParagraphView 负责的视图数

getLayoutView

protected View getLayoutView(int index)

返回给定 index 处的视图。段落的子视图是已用于安排表示子元素的 View 片段的行。此方法返回负责子元素索引的视图（拆分前）。这些是从工厂生成（以表示子元素）且用于布局的 View。

参数：

index - 所需视图的 index

返回：

index 处的视图

adjustRow

protected void adjustRow(javax.swing.text.ParagraphView.Row r,
                         int desiredSpan,
                         int x)

如有可能，调整给定行以使其处于布局区域内。默认情况下，此操作将试图能在最接近行结尾的位置找到最高拆分权重。如果遇到强制拆分，则该拆分将定位于强制拆分的位置。

这是内部用法，不应直接使用。

参数：

r - 要调整到当前布局区域内的行

desiredSpan - 当前布局区域，该值 >= 0

x - r 开始处的位置

getNextNorthSouthVisualPositionFrom

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

在东或西方向返回光标的下一个可视位置。通过 CompositeView 重写。

覆盖：

类 CompositeView 中的 getNextNorthSouthVisualPositionFrom

参数：

pos - 模型中的位置

b - Position.Bias.Forward 或 Position.Bias.Backward

a - 要呈现的分配区域

direction - SwingConstants.NORTH 或 SwingConstants.SOUTH

biasRet - 包含以此方法查到的偏差的数组

返回：

模型中表示下一个位置可视处的位置

抛出：

BadLocationException

另请参见：

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

getClosestPositionTo

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

返回最接近 x 处的模型位置。rowIndex 是要在其中查找的视图对应的索引。

参数：

pos - 模型中的位置

a - 要呈现的分配区域

direction - 它是以下值之一：

• SwingConstants.NORTH
• SwingConstants.SOUTH

biasRet - 包含在此方法中查到的偏差的数组

rowIndex - 视图的索引

x - 需要的 x 坐标

返回：

最接近 x 的模型位置

抛出：

BadLocationException

flipEastAndWestAtEnds

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

确定下一个视图要布置的方向。假定 View 位于索引 n 处，通常 View 是从左向右放置的，所以在东面的 View 将位于索引 n + 1 处，在西面的 View 将位于索引 n - 1 处。在某些情况下（例如双向文本中）有可能东面的 View 不是位于 n + 1 处，而是位于 n - 1 处，或者西面的 View 不是位于 n - 1 处，而是位于索引 n + 1 处。这种情况下，该方法将返回 true，指示 View 按降序放置。

如果文本在某个位置从右向左布置，则返回 true；否则返回 false。

覆盖：

类 BoxView 中的 flipEastAndWestAtEnds

参数：

position - 模型中的位置

bias - Position.Bias.Forward 或 Position.Bias.Backward

返回：

如果文本在某个位置从右向左布置，则返回 true；否则返回 false。

getFlowSpan

public int getFlowSpan(int index)

获取给定子索引流入的约束区域。

覆盖：

类 FlowView 中的 getFlowSpan

参数：

index - 查询视图的索引

返回：

在 index 处给定视图的约束区域

从以下版本开始：

1.3

另请参见：

FlowView.getFlowStart(int)

getFlowStart

public int getFlowStart(int index)

获取沿流轴的流区域开始位置。

覆盖：

类 FlowView 中的 getFlowStart

参数：

index - 查询视图的索引

返回：

在 index 处给定视图的位置

从以下版本开始：

1.3

另请参见：

FlowView.getFlowSpan(int)

createRow

protected View createRow()

创建用于在流中存储子级行值的 View。

指定者：

类 FlowView 中的 createRow

返回：

新的 View

从以下版本开始：

1.3

nextTabStop

public float nextTabStop(float x,
                         int tabOffset)

返回给定了参照位置的下一个制表符位位置。此视图实现制表符坐标系，并在布局进程中在逻辑子级上调用 getTabbedSpan，以确定该子级所需的区域。逻辑子级可以将其制表符扩展委托给知道如何扩展制表符的段落。LabelView 是将其制表符扩展需要委托给段落的视图的示例。

实现此方法以尝试在段落元素的属性集合中查找 TabSet。如果能找到一个制表符集，将使用其设置；否则将提供默认扩展。制表符扩展的基本位置是段落左部最近分配的位置（即子级布局的依据）。

指定者：

接口 TabExpander 中的 nextTabStop

参数：

x - X 引用位置

tabOffset - 在文本流内放置制表符的位置，该值 >= 0

返回：

制表符扩展的尾端，该值 >= 0

另请参见：

TabSet, TabStop, LabelView

getTabSet

protected TabSet getTabSet()

获取计算制表符时使用的 Tabset。

返回：

TabSet

getPartialSize

protected float getPartialSize(int startOffset,
                               int endOffset)

返回 startOffset 和 endOffset 之间的视图使用的大小。如果子视图实现 TabableView 接口，则此方法将使用 getPartialView 计算该大小。如果需要某个大小，并且 View 未实现 TabableView 接口，则使用 preferredSpan。

参数：

startOffset - 起始文档偏移量，该值 >= 0

endOffset - 结束文档偏移量，该值 >= startOffset

返回：

大小，该值 >= 0

findOffsetToCharactersInString

protected int findOffsetToCharactersInString(char[] string,
                                             int start)

根据 string 中字符查找文档中的下一个字符，起点是偏移量 start。如果找不到字符，则返回 -1。

参数：

string - 由字符组成的字符串

start - 模型中的起始位置，该值 >= 0

返回：

文档偏移量；如果找不到字符，则返回 -1

getTabBase

protected float getTabBase()

返回从中计算制表符的位置。

返回：

从中计算制表符的位置

paint

public void paint(Graphics g,
                  Shape a)

使用给定的呈现面和该面上的区域进行呈现。实现此方法以便在拆分用作制表符计算的基坐标之后委托给超类。

覆盖：

类 BoxView 中的 paint

参数：

g - 要使用的呈现表面

a - 分配的要在其中呈现的区域

另请参见：

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

getAlignment

public float getAlignment(int axis)

确定此视图沿某轴所需的对齐方式。实现此方法以使第一行中心沿 y 轴对齐，而默认是沿 x 轴对齐。

覆盖：

类 BoxView 中的 getAlignment

参数：

axis - 可以是 View.X_AXIS，也可以是 View.Y_AXIS

返回：

所需的对齐方式。这应是 0.0 和 1.0 之间的值，其中 0.0 指示原点对齐，1.0 指示原点以外的整个区域对齐。0.5 对齐方式指视图中心对齐。

breakView

public View breakView(int axis,
                      float len,
                      Shape a)

以给定的长度在给定的轴上拆分此视图。

ParagraphView 实例只可沿 Y_AXIS 且只在 len 位于第一行之后时拆分。

参数：

axis - 可以是 View.X_AXIS，也可以是 View.Y_AXIS

len - 指定沿给定轴可能需要拆分的位置，该值 >= 0

a - 视图的当前分配区域

返回：

如果视图可以拆分，则返回表示给定区域的视图片段；如果视图不支持拆分行为，则返回视图本身

另请参见：

View.breakView(int, int, float, float)

getBreakWeight

public int getBreakWeight(int axis,
                          float len)

获取给定位置的拆分权重。

ParagraphView 实例只沿 Y_AXIS 且只在 len 位于第一行之后拆分。如果长度小于一行，则返回 BadBreakWeight 的值。

参数：

axis - 可以是 View.X_AXIS，也可以是 View.Y_AXIS

len - 指定可能需要拆分的位置，该值 >= 0

返回：

指示在此处拆分的可能性；GoodBreakWeight 或 BadBreakWeight

另请参见：

View.getBreakWeight(int, float, float)

changedUpdate

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

发出通知，通知文档中此视图负责的某个位置的属性已更改。

覆盖：

类 FlowView 中的 changedUpdate

参数：

changes - 来自相关文档的更改信息

a - 视图的当前分配区域

f - 用于重建的工厂（如果该视图有子级）

另请参见：

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

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。