Question

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

---

public final class TextHitInfo

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

---

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

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

覆盖：

类 Object 中的 equals

参数：

obj - 测试相等性的 Object

返回：

如果指定的 Object 等于此 TextHitInfo ，则返回 true ；否则返回 false 。

另请参见：

Object.hashCode() , Hashtable

---

equals

public boolean equals(TextHitInfohitInfo)

如果指定的 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(intcharIndex)

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

参数：

charIndex - 目标字符的索引

返回：

在指定 charIndex 处字符的开始边上的 TextHitInfo 。

---

trailing

public static TextHitInfo trailing(intcharIndex)

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

参数：

charIndex - 目标字符的索引

返回：

在指定 charIndex 处的字符的结尾边上的 TextHitInfo 。

---

beforeOffset

public static TextHitInfo beforeOffset(intoffset)

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

参数：

offset - 与偏移量之前的字符关联的偏移量

返回：

在指定偏移量处的 TextHitInfo 。

---

afterOffset

public static TextHitInfo afterOffset(intoffset)

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

参数：

offset - 与偏移量之后的字符关联的偏移量

返回：

在指定偏移量处的 TextHitInfo 。

---

getOtherHit

public TextHitInfo getOtherHit()

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

返回：

插入点另一侧的 TextHitInfo 。

---

getOffsetHit

public TextHitInfo getOffsetHit(intdelta)

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

参数：

delta - 偏移此 charIndex 的值

返回：

一个 TextHitInfo ，其 charIndex 从此 TextHitInfo 的 charIndex 偏移 delta 。