java.awt.font
类 TextHitInfo

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

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。