TextHitInfo

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt.font
类 TextHitInfo

java.lang.Object
  java.awt.font.TextHitInfo

public final class TextHitInfo
extends Object
extends Object

TextHitInfo 类表示文本模型中的字符位置以及字符的斜线或“边”。斜线是开始边（对于从左到右的字符为左边缘）或者结尾边（对于从左到右的字符为右边缘）。TextHitInfo 的实例用于指定插入符和在文本中的插入位置。

例如，可以考虑一下文本 "abc"。TextHitInfo.trailing(1) 对应于文本中 'b' 的右边。

TextHitInfo 主要由 TextLayout 和 TextLayout 的客户端使用。TextLayout 的客户端查询 TextHitInfo 实例，以获得插入偏移量，新文本在此处插入到文本模型中。插入偏移量等于 TextHitInfo 中的字符位置（如果斜线为开始边），或者在某个字符之后（如果斜线为结尾边）。TextHitInfo.trailing(1) 的插入偏移量为 2。

有时，构造一个具有与现有 TextHitInfo 相同的插入偏移量的 TextHitInfo 很方便，不过要在相对的字符上。getOtherHit 方法构造一个具有与现有 TextHitInfo 相同的插入偏移量的新 TextHitInfo，目标字符在插入偏移量的另一侧。在 trailing(1) 上调用 getOtherHit 将返回 leading(2)。一般来说，trailing(n) 的 getOtherHit 返回 leading(n+1)，leading(n) 的 getOtherHit 返回 trailing(n-1)。

示例：

将图形点转换为文本模型中的插入点

 TextLayout layout = ...;
 Point2D.Float hitPoint = ...;
 TextHitInfo hitInfo = layout.hitTestChar(hitPoint.x, hitPoint.y);
 int insPoint = hitInfo.getInsertionIndex();
 // insPoint is relative to layout;  may need to adjust for use 
 // in a text model

另请参见：: TextLayout

方法摘要
`static TextHitInfo`	`afterOffset(int offset)` 在指定偏移量处创建一个与偏移量之后的字符关联的 `TextHitInfo`。
`static TextHitInfo`	`beforeOffset(int offset)` 在指定偏移量处创建一个与偏移量之前的字符关联的 `TextHitInfo`。
`boolean`	`equals(Object obj)` 如果指定的 `Object` 是一个 `TextHitInfo` 并且等于此 `TextHitInfo`，则返回 `true`。
`boolean`	`equals(TextHitInfo hitInfo)` 如果指定的 `TextHitInfo` 具有与此 `TextHitInfo` 相同的 `charIndex` 和 `isLeadingEdge`，则返回 `true`。
`int`	`getCharIndex()` 返回目标字符的索引。
`int`	`getInsertionIndex()` 返回插入索引。
`TextHitInfo`	`getOffsetHit(int delta)` 创建一个 `TextHitInfo`，其字符索引从此 `TextHitInfo` 的 `charIndex` 偏移 `delta`。
`TextHitInfo`	`getOtherHit()` 在插入点的另一侧创建一个 `TextHitInfo`。
`int`	`hashCode()` 返回哈希码。
`boolean`	`isLeadingEdge()` 如果字符的开始边是插入点，则返回 `true`。
`static TextHitInfo`	`leading(int charIndex)` 在指定 `charIndex` 处的字符开始边上创建一个 `TextHitInfo`。
`String`	`toString()` 返回表示此 TextHitInfo 的 `String`，只用于调试目的。
`static TextHitInfo`	`trailing(int charIndex)` 在指定 `charIndex` 处的字符的结尾边上创建一个 TextHitInfo。

从类 java.lang.Object 继承的方法
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

方法详细信息

getCharIndex

public int getCharIndex()

返回目标字符的索引。

返回：: 目标字符的索引。

isLeadingEdge

public boolean isLeadingEdge()

如果字符的开始边是插入点，则返回 true。

返回：: 如果字符的开始边是插入点，则返回 true；否则返回 false。

getInsertionIndex

public int getInsertionIndex()

返回插入索引。如果字符的开始边是插入点，则插入索引为字符索引，如果字符的结尾边是插入点，则插入索引比字符索引大 1。

返回：: 插入索引。

hashCode

public int hashCode()

返回哈希码。

覆盖：: 类 Object 中的 hashCode

返回：: 此 TextHitInfo 的哈希码，也是此 TextHitInfo 的 charIndex。
另请参见：: Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

如果指定的 Object 是一个 TextHitInfo 并且等于此 TextHitInfo，则返回 true。

覆盖：: 类 Object 中的 equals

参数：: obj - 测试相等性的 Object
返回：: 如果指定的 Object 等于此 TextHitInfo，则返回 true；否则返回 false。
另请参见：: Object.hashCode(), Hashtable

equals

public boolean equals(TextHitInfo hitInfo)

如果指定的 TextHitInfo 具有与此 TextHitInfo 相同的 charIndex 和 isLeadingEdge，则返回 true。这与具有相同插入偏移量不同。

参数：: hitInfo - 一个指定的 TextHitInfo
返回：: 如果指定的 TextHitInfo 具有与此 TextHitInfo 相同的 charIndex 和 isLeadingEdge，则返回 true。

toString

public String toString()

返回表示此 TextHitInfo 的 String，只用于调试目的。

覆盖：: 类 Object 中的 toString

返回：: 表示此 TextHitInfo 的 String。

leading

public static TextHitInfo leading(int charIndex)

在指定 charIndex 处的字符开始边上创建一个 TextHitInfo。

参数：: charIndex - 目标字符的索引
返回：: 在指定 charIndex 处字符的开始边上的 TextHitInfo。

trailing

public static TextHitInfo trailing(int charIndex)

在指定 charIndex 处的字符的结尾边上创建一个 TextHitInfo。

参数：: charIndex - 目标字符的索引
返回：: 在指定 charIndex 处的字符的结尾边上的 TextHitInfo。

beforeOffset

public static TextHitInfo beforeOffset(int offset)

在指定偏移量处创建一个与偏移量之前的字符关联的 TextHitInfo。

参数：: offset - 与偏移量之前的字符关联的偏移量
返回：: 在指定偏移量处的 TextHitInfo。

afterOffset

public static TextHitInfo afterOffset(int offset)

在指定偏移量处创建一个与偏移量之后的字符关联的 TextHitInfo。

参数：: offset - 与偏移量之后的字符关联的偏移量
返回：: 在指定偏移量处的 TextHitInfo。

getOtherHit

public TextHitInfo getOtherHit()

在插入点的另一侧创建一个 TextHitInfo。此 TextHitInfo 保持不变。

返回：: 插入点另一侧的 TextHitInfo。

getOffsetHit

public TextHitInfo getOffsetHit(int delta)

创建一个 TextHitInfo，其字符索引从此 TextHitInfo 的 charIndex 偏移 delta。此 TextHitInfo 保持不变。

参数：: delta - 偏移此 charIndex 的值
返回：: 一个 TextHitInfo，其 charIndex 从此 TextHitInfo 的 charIndex 偏移 delta。

概述