Java java.awt.font 类 TextMeasurer（JDK5）

所有类

java.awt.font
类 TextMeasurer

java.lang.Object
  java.awt.font.TextMeasurer

所有已实现的接口：

Cloneable

public final class TextMeasurer
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements Cloneable
   
   
   
   
   

TextMeasurer 类提供换行所需的基本操作：测量到给定的 advance，确定字符范围的 advance，并为字符范围生成一个 TextLayout。该类还提供了段落增量编辑的方法。

TextMeasurer 对象是使用表示单个文本段落的 AttributedCharacterIterator 构造的。AttributedCharacterIterator 的 getBeginIndex 方法返回的值定义了第一个字符的绝对索引。AttributedCharacterIterator 的 getEndIndex 方法返回的值定义了最后一个字符后的索引。这些值定义了调用 TextMeasurer 的时使用的索引范围。例如，要通过调用获取文本范围的 advance 或文本范围的换行，则必须使用开始索引值和结束索引值之间的索引。调用 insertChar 和 deleteChar 重置 TextMeasurer 要使用在这些调用中传入的 AttributedCharacterIterator 的开始索引和结束索引。

大多数客户端将使用更方便的 LineBreakMeasurer，它实现了标准的换行策略（在每一行上放置尽可能多的适合的单词）。

从以下版本开始：

1.3

另请参见：

LineBreakMeasurer

TextMeasurer

public TextMeasurer(AttributedCharacterIterator text,
                    FontRenderContext frc)

从源文本构造 TextMeasurer。源文本应为一个整段。

参数：

text - 源段落。不能为 null。

frc - 关于需要正确测量文本的图形设备的信息。不能为 null。

clone

protected Object clone()

从类 Object 复制的描述

创建并返回此对象的一个副本。“副本”的准确含义可能依赖于对象的类。一般来说，对于任何对象 x，如果表达式：

x.clone() != x

是正确的，则表达式：

x.clone().getClass() == x.getClass()

将为 true，但这些不是绝对条件。一般情况下是：

x.clone().equals(x)

将为 true，但这不是绝对条件。

按照惯例，返回的对象应该通过调用 super.clone 获得。如果一个类及其所有的超类（Object 除外）都遵守此约定，则 x.clone().getClass() == x.getClass()。

按照惯例，此方法返回的对象应该独立于该对象（正被克隆的对象）。要获得此独立性，在 super.clone 返回对象之前，有必要对该对象的一个或多个字段进行修改。这通常意味着要复制包含正在被克隆对象的内部“深层结构”的所有可变对象，并使用对副本的引用替换对这些对象的引用。如果一个类只包含基本字段或对不变对象的引用，那么通常不需要修改 super.clone 返回的对象中的字段。

Object 类的 clone 方法执行特定的克隆操作。首先，如果此对象的类不能实现接口 Cloneable，则会抛出 CloneNotSupportedException。注意：所有的数组都被视为实现接口 Cloneable。否则，此方法会创建此对象的类的一个新实例，并像通过分配那样，严格使用此对象相应字段的内容初始化该对象的所有字段；这些字段的内容没有被自我克隆。所以，此方法执行的是该对象的“浅表复制”，而不“深层复制”操作。

Object 类本身不实现接口 Cloneable，所以在类为 Object 的对象上调用 clone 方法将会导致在运行时抛出异常。

覆盖：

类 Object 中的 clone

返回：

此实例的一个克隆。

另请参见：

Cloneable

getLineBreakIndex

public int getLineBreakIndex(int start,
                             float maxAdvance)

返回不能置于文本行上的第一个字符，该文本行从 start 开始并可能测量到图形宽度的 maxAdvance。

参数：

start - 从此处开始测量的字符索引。start 是一个绝对索引，而不是相对于段落开始处的相对索引

maxAdvance - 文本行必须符合的图形宽度

返回：

置于从 start 开始、不长于 maxAdvance 文本行上的最后一个字符后的索引

抛出：

IllegalArgumentException - 如果 start 小于段落的开始位置。

getAdvanceBetween

public float getAdvanceBetween(int start,
                               int limit)

返回从 start 开始并包括一直到 limit 的字符的行的图形宽度。start 和 limit 是绝对索引，不是相对于段落开始处的相对索引。

参数：

start - 开始测量的字符索引

limit - 停止测量的字符索引

返回：

从 start 处开始并包括一直到 limit 的字符的行的图形宽度

抛出：

IndexOutOfBoundsException - 如果 limit 小于 start

IllegalArgumentException - 如果 start 或 limit 不在段落开始处和段落结束处之间。

getLayout

public TextLayout getLayout(int start,
                            int limit)

返回给定字符范围上的 TextLayout。

参数：

start - 第一个字符的索引

limit - 最后一个字符之后的索引。必须大于 start

返回：

从 start 开始（不包括）直到 limit 的字符的 TextLayout

抛出：

IndexOutOfBoundsException - 如果 limit 小于 start

IllegalArgumentException - 如果 start 或 limit 不在段落开始处和段落结束处之间。

insertChar

public void insertChar(AttributedCharacterIterator newParagraph,
                       int insertPos)

在将单个字符插入当前由此 TextMeasurer 表示的段落中后，更新该 TextMeasurer。在此调用后，该 TextMeasurer 等效于从文本创建的新 TextMeasurer；不过，更新现有 TextMeasurer 通常比重新创建一个新 TextMeasurer 效率更高。

参数：

newParagraph - 执行插入后段落的文本。不能为 null。

insertPos - 插入字符在文本中的位置。不能小于 newParagraph 的开始，且必须小于 newParagraph 的结束。

抛出：

IndexOutOfBoundsException - 如果 insertPos 小于 newParagraph 的开始或者大于或等于 newParagraph 的结束

NullPointerException - 如果 newParagraph 为 null

deleteChar

public void deleteChar(AttributedCharacterIterator newParagraph,
                       int deletePos)

从当前由此 TextMeasurer 表示的段落中删除一个字符后，更新 TextMeasurer。在此调用后，该 TextMeasurer 等效于从文本创建的新 TextMeasurer；不过，更新现有 TextMeasurer 通常比重新创建一个新 TextMeasurer 效率更高。

参数：

newParagraph - 执行删除后的段落文本。不能为 null。

deletePos - 所移除字符在文本中的位置。不能小于 newParagraph 的开始，而且不能大于 newParagraph 的结束。

抛出：

IndexOutOfBoundsException - 如果 deletePos 小于 newParagraph 的开始或大于 newParagraph 的结束

NullPointerException - 如果 newParagraph 为 null