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

方法摘要

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。