|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.font.TextMeasurer
public final class TextMeasurer
TextMeasurer
类提供换行所需的基本操作:测量到给定的 advance,确定字符范围的 advance,并为字符范围生成一个 TextLayout
。该类还提供了段落增量编辑的方法。
TextMeasurer
对象是使用表示单个文本段落的 AttributedCharacterIterator
构造的。AttributedCharacterIterator
的 getBeginIndex
方法返回的值定义了第一个字符的绝对索引。AttributedCharacterIterator
的 getEndIndex
方法返回的值定义了最后一个字符后的索引。这些值定义了调用 TextMeasurer
的时使用的索引范围。例如,要通过调用获取文本范围的 advance 或文本范围的换行,则必须使用开始索引值和结束索引值之间的索引。调用 insertChar
和 deleteChar
重置 TextMeasurer
要使用在这些调用中传入的 AttributedCharacterIterator
的开始索引和结束索引。
大多数客户端将使用更方便的 LineBreakMeasurer
,它实现了标准的换行策略(在每一行上放置尽可能多的适合的单词)。
LineBreakMeasurer
构造方法摘要 | |
---|---|
TextMeasurer(AttributedCharacterIterator text,
FontRenderContext frc)
从源文本构造 TextMeasurer 。 |
方法摘要 | |
---|---|
protected Object |
clone()
创建并返回此对象的一个副本。 |
void |
deleteChar(AttributedCharacterIterator newParagraph,
int deletePos)
从当前由此 TextMeasurer 表示的段落中删除一个字符后,更新 TextMeasurer 。 |
float |
getAdvanceBetween(int start,
int limit)
返回从 start 开始并包括一直到 limit 的字符的行的图形宽度。 |
TextLayout |
getLayout(int start,
int limit)
返回给定字符范围上的 TextLayout 。 |
int |
getLineBreakIndex(int start,
float maxAdvance)
返回不能置于文本行上的第一个字符,该文本行从 start 开始并可能测量到图形宽度的 maxAdvance 。 |
void |
insertChar(AttributedCharacterIterator newParagraph,
int insertPos)
在将单个字符插入当前由此 TextMeasurer 表示的段落中后,更新该 TextMeasurer 。 |
从类 java.lang.Object 继承的方法 |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public TextMeasurer(AttributedCharacterIterator text, FontRenderContext frc)
TextMeasurer
。源文本应为一个整段。
text
- 源段落。不能为 null。frc
- 关于需要正确测量文本的图形设备的信息。不能为 null。方法详细信息 |
---|
protected Object clone()
Object
复制的描述为 true,表达式:x.clone() != x
也为 true,但这些并非必须要满足的要求。一般情况下:x.clone().getClass() == x.getClass()
为 true,但这并非必须要满足的要求。x.clone().equals(x)
按照惯例,返回的对象应该通过调用 super.clone 获得。如果一个类及其所有的超类(Object 除外)都遵守此约定,则 x.clone().getClass() == x.getClass()。
按照惯例,此方法返回的对象应该独立于该对象(正被复制的对象)。要获得此独立性,在 super.clone 返回对象之前,有必要对该对象的一个或多个字段进行修改。这通常意味着要复制包含正在被复制对象的内部“深层结构”的所有可变对象,并使用对副本的引用替换对这些对象的引用。如果一个类只包含基本字段或对不变对象的引用,那么通常不需要修改 super.clone 返回的对象中的字段。
Object 类的 clone 方法执行特定的复制操作。首先,如果此对象的类不能实现接口 Cloneable,则会抛出 CloneNotSupportedException。注意,所有的数组都被视为实现接口 Cloneable。否则,此方法会创建此对象的类的一个新实例,并像通过分配那样,严格使用此对象相应字段的内容初始化该对象的所有字段;这些字段的内容没有被自我复制。所以,此方法执行的是该对象的“浅表复制”,而不“深层复制”操作。
Object 类本身不实现接口 Cloneable,所以在类为 Object 的对象上调用 clone 方法将会导致在运行时抛出异常。
Object
中的 clone
Cloneable
public int getLineBreakIndex(int start, float maxAdvance)
start
开始并可能测量到图形宽度的 maxAdvance
。
start
- 从此处开始测量的字符索引。start
是一个绝对索引,而不是相对于段落开始处的相对索引maxAdvance
- 文本行必须符合的图形宽度
start
开始、不长于 maxAdvance
文本行上的最后一个字符后的索引
IllegalArgumentException
- 如果 start
小于段落的开始位置。public float getAdvanceBetween(int start, int limit)
start
开始并包括一直到 limit
的字符的行的图形宽度。start
和 limit
是绝对索引,不是相对于段落开始处的相对索引。
start
- 开始测量的字符索引limit
- 停止测量的字符索引
start
处开始并包括一直到 limit
的字符的行的图形宽度
IndexOutOfBoundsException
- 如果 limit
小于 start
IllegalArgumentException
- 如果 start
或 limit
不在段落开始处和段落结束处之间。public TextLayout getLayout(int start, int limit)
TextLayout
。
start
- 第一个字符的索引limit
- 最后一个字符之后的索引。必须大于 start
start
开始(不包括)直到 limit
的字符的 TextLayout
IndexOutOfBoundsException
- 如果 limit
小于 start
IllegalArgumentException
- 如果 start
或 limit
不在段落开始处和段落结束处之间。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
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
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。