java.awt.font
클래스 TextHitInfo

java.lang.Object 
  |
  +--java.awt.font.TextHitInfo

public final class TextHitInfo

extends Object

TextHitInfo 클래스는 텍스트 모델내의 캐릭터의 위치, 및 그 캐릭터의 「바이어스 (사이드)」를 나타냅니다. 바이어스는 「리딩 (왼쪽에서 오른쪽으로 기술하는 캐릭터의 좌단)」또는 「트레이 링 (왼쪽에서 오른쪽으로 기술하는 캐릭터의 우단)의 어느 쪽인지입니다. TextHitInfo 의 인스턴스는 텍스트내의 caret 및 삽입 위치를 지정하기 위해서 사용됩니다.

예를 들어, 텍스트의 「abc」를 생각해 주세요. TextHitInfo.trailing(1)는 그 텍스트의 「b」의 우측으로 대응합니다.

TextHitInfo 는 주로 TextLayout 및 TextLayout 의 클라이언트에 의해 사용됩니다. TextLayout 의 클라이언트는 TextHitInfo 의 인스턴스에 삽입 오프셋(offset)를 문의합니다. 삽입 오프셋(offset)란, 텍스트 모델내에서 새로운 텍스트가 삽입되는 위치입니다. 삽입 오프셋(offset)는 바이어스가 리딩의 경우는 TextHitInfo 의 캐릭터의 위치와 동일하고, 바이어스가 트레이 링의 경우는 1 캐릭터분 후의 위치가 됩니다. TextHitInfo.trailing(1)의 삽입 오프셋(offset)는 2 입니다.

TextHitInfo 의 작성은 기존의 것과 같은 삽입 오프셋(offset), 다만 반대의 캐릭터로 실시하면 편리한 경우가 있습니다. getOtherHit 메소드는 기존의 것과 같은 삽입 오프셋(offset), 삽입 오프셋(offset)의 반대측의 캐릭터의 히트로 새로운 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) 오프셋(offset)의 뒤의 캐릭터에 관련지을 수 있고 있는 지정된 오프셋(offset)로 TextHitInfo 를 작성합니다.
static TextHitInfo	beforeOffset (int offset) 오프셋(offset)의 전의 캐릭터에 관련지을 수 있고 있는 지정된 오프셋(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) 이 charIndex 로부터 delta 만 오프셋(offset) 한 캐릭터 인덱스를 가지는 TextHitInfo 를 작성합니다.
TextHitInfo	getOtherHit () 삽입 포인트의 반대측에서 TextHitInfo 를 작성합니다.
int	hashCode () 해시 코드를 돌려줍니다.
boolean	isLeadingEdge () 캐릭터의 리딩 엣지가 히트 되었을 경우에 true 를 돌려줍니다.
static TextHitInfo	leading (int charIndex) 지정된 charIndex 에 있는 캐릭터의 리딩 엣지에서 TextHitInfo 를 작성합니다.
String	toString () 히트를 나타내는 String 를 돌려줍니다.
static TextHitInfo	trailing (int charIndex) 지정된 charIndex 에 있는 캐릭터의 트레이 링 엣지에서 히트를 작성합니다.

클래스 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()

해시 코드를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 TextHitInfo 의 해시 코드. 이 TextHitInfo 의 charIndex 이기도 한

관련 항목:

Object.equals(java.lang.Object) , Hashtable

equals

public boolean equals(Object  obj)

지정된 Object 가 TextHitInfo 이며, 이 TextHitInfo 와 동일한 경우에 true 를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 동일한지 어떤지가 판정되는 Object

반환값:

지정된 Object 가 이 TextHitInfo 와 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode() , Hashtable

equals

public boolean equals(TextHitInfo  hitInfo)

지정된 TextHitInfo 가 이 TextHitInfo 와 같은 charIndex 및 isLeadingEdge 를 가지는 경우에 true 를 돌려줍니다. 이것은 같은 삽입 오프셋(offset)를 가지는 것과 같지는 않습니다.

파라미터:

hitInfo - TextHitInfo

반환값:

지정된 TextHitInfo 가 이 TextHitInfo 와 같은 charIndex 및 isLeadingEdge 를 가지는 경우는 true

toString

public String  toString()

히트를 나타내는 String 를 돌려줍니다. 디버그용으로만 사용됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 TextHitInfo 를 나타내는 String

leading

public static TextHitInfo  leading(int charIndex)

지정된 charIndex 에 있는 캐릭터의 리딩 엣지에서 TextHitInfo 를 작성합니다.

파라미터:

charIndex - 캐릭터 히트의 인덱스

반환값:

지정된 charIndex 에 있는 캐릭터의 리딩 엣지의 TextHitInfo

trailing

public static TextHitInfo  trailing(int charIndex)

지정된 charIndex 에 있는 캐릭터의 트레이 링 엣지에서 히트를 작성합니다.

파라미터:

charIndex - 캐릭터 히트의 인덱스

반환값:

지정된 charIndex 에 있는 캐릭터의 트레이 링 엣지의 TextHitInfo

beforeOffset

public static TextHitInfo  beforeOffset(int offset)

오프셋(offset)의 전의 캐릭터에 관련지을 수 있고 있는 지정된 오프셋(offset)로 TextHitInfo 를 작성합니다.

파라미터:

offset - 오프셋(offset)의 전의 캐릭터에 관련지을 수 있고 있는 오프셋(offset)

반환값:

지정된 오프셋(offset)의 TextHitInfo

afterOffset

public static TextHitInfo  afterOffset(int offset)

오프셋(offset)의 뒤의 캐릭터에 관련지을 수 있고 있는 지정된 오프셋(offset)로 TextHitInfo 를 작성합니다.

파라미터:

offset - 오프셋(offset)의 뒤의 캐릭터에 관련지을 수 있고 있는 오프셋(offset)

반환값:

지정된 오프셋(offset)의 TextHitInfo

getOtherHit

public TextHitInfo  getOtherHit()

삽입 포인트의 반대측에서 TextHitInfo 를 작성합니다. 이 TextHitInfo 는 바뀌지 않습니다.

반환값:

삽입 포인트의 반대측의 TextHitInfo

getOffsetHit

public TextHitInfo  getOffsetHit(int delta)

이 charIndex 로부터 delta 만 오프셋(offset) 한 캐릭터 인덱스를 가지는 TextHitInfo 를 작성합니다. 이 TextHitInfo 는 바뀌지 않습니다.

파라미터:

delta - 이 charIndex 에 대한 오프셋(offset)치

반환값:

이 TextHitInfo 의 charIndex 로부터 delta 만 오프셋(offset) 한 charIndex 를 가지는 TextHitInfo