|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Object | +--java.awt.font.TextHitInfo
The TextHitInfo class represents a character position in a
text model, and a bias, or "side," of the character. Biases are
either leading (the left edge, for a left-to-right character)
or trailing (the right edge, for a left-to-right character).
Instances of TextHitInfo are used to specify caret and
insertion positions within text.
For example, consider the text "abc". TextHitInfo.trailing(1) corresponds to the right side of the 'b' in the text.
TextHitInfo is used primarily by TextLayout and
clients of TextLayout. Clients of TextLayout
query TextHitInfo instances for an insertion offset, where
new text is inserted into the text model. The insertion offset is equal
to the character position in the TextHitInfo if the bias
is leading, and one character after if the bias is trailing. The
insertion offset for TextHitInfo.trailing(1) is 2.
Sometimes it is convenient to construct a TextHitInfo with
the same insertion offset as an existing one, but on the opposite
character. The getOtherHit method constructs a new
TextHitInfo with the same insertion offset as an existing
one, with a hit on the character on the other side of the insertion offset.
Calling getOtherHit on trailing(1) would return leading(2).
In general, getOtherHit for trailing(n) returns
leading(n+1) and getOtherHit for leading(n)
returns trailing(n-1).
Example:
Converting a graphical point to an insertion point within a text model
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| Method Summary | |
static TextHitInfo |
afterOffset(int offset)
Creates a TextHitInfo at the specified offset,
associated with the character after the offset. |
static TextHitInfo |
beforeOffset(int offset)
Creates a TextHitInfo at the specified offset,
associated with the character before the offset. |
boolean |
equals(Object obj)
Returns true if the specified Object is a
TextHitInfo and equals this TextHitInfo. |
boolean |
equals(TextHitInfo hitInfo)
Returns true if the specified TextHitInfo
has the same charIndex and isLeadingEdge
as this TextHitInfo. |
int |
getCharIndex()
Returns the index of the character hit. |
int |
getInsertionIndex()
Returns the insertion index. |
TextHitInfo |
getOffsetHit(int delta)
Creates a TextHitInfo whose character index is offset
by delta from the charIndex of this
TextHitInfo. |
TextHitInfo |
getOtherHit()
Creates a TextHitInfo on the other side of the
insertion point. |
int |
hashCode()
Returns the hash code. |
boolean |
isLeadingEdge()
Returns true if the leading edge of the character was
hit. |
static TextHitInfo |
leading(int charIndex)
Creates a TextHitInfo on the leading edge of the
character at the specified charIndex. |
String |
toString()
Returns a String representing the hit for debugging
use only. |
static TextHitInfo |
trailing(int charIndex)
Creates a hit on the trailing edge of the character at the specified charIndex. |
| Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Method Detail |
public int getCharIndex()
public boolean isLeadingEdge()
true if the leading edge of the character was
hit.true if the leading edge of the character was
hit; false otherwise.public int getInsertionIndex()
public int hashCode()
hashCode in class ObjectTextHitInfo, which is
also the charIndex of this TextHitInfo.public boolean equals(Object obj)
true if the specified Object is a
TextHitInfo and equals this TextHitInfo.equals in class Objectobj - the Object to test for equalitytrue if the specified Object
equals this TextHitInfo; false otherwise.public boolean equals(TextHitInfo hitInfo)
true if the specified TextHitInfo
has the same charIndex and isLeadingEdge
as this TextHitInfo. This is not the same as having
the same insertion offset.hitInfo - a specified TextHitInfotrue if the specified TextHitInfo
has the same charIndex and isLeadingEdge
as this TextHitInfo.public String toString()
String representing the hit for debugging
use only.toString in class ObjectString representing this
TextHitInfo.public static TextHitInfo leading(int charIndex)
TextHitInfo on the leading edge of the
character at the specified charIndex.charIndex - the index of the character hitTextHitInfo on the leading edge of the
character at the specified charIndex.public static TextHitInfo trailing(int charIndex)
charIndex.charIndex - the index of the character hitTextHitInfo on the trailing edge of the
character at the specified charIndex.public static TextHitInfo beforeOffset(int offset)
TextHitInfo at the specified offset,
associated with the character before the offset.offset - an offset associated with the character before
the offsetTextHitInfo at the specified offset.public static TextHitInfo afterOffset(int offset)
TextHitInfo at the specified offset,
associated with the character after the offset.offset - an offset associated with the character after
the offsetTextHitInfo at the specified offset.public TextHitInfo getOtherHit()
TextHitInfo on the other side of the
insertion point. This TextHitInfo remains unchanged.TextHitInfo on the other side of the
insertion point.public TextHitInfo getOffsetHit(int delta)
TextHitInfo whose character index is offset
by delta from the charIndex of this
TextHitInfo. This TextHitInfo remains
unchanged.delta - the value to offset this charIndexTextHitInfo whose charIndex is
offset by delta from the charIndex of
this TextHitInfo.
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.