TextBoundsInfo.Builder

Builder

public Builder (int start, 
                int end)

Create a builder for TextBoundsInfo.

build

public TextBoundsInfo build ()

Create the TextBoundsInfo using the parameters in this Builder.

clear

public TextBoundsInfo.Builder clear ()

Clear all the parameters set on this Builder to reuse it.

setCharacterBidiLevel

public TextBoundsInfo.Builder setCharacterBidiLevel (int[] characterBidiLevels)

Set the BiDi levels for the character. The bidiLevel of the i-th character in the editor is stored at index (i - start). The length of the given array must equal to (end - start).
BiDi level is defined by the unicode bidirectional algorithm . One can determine whether a character's direction is right-to-left (RTL) or left-to-right (LTR) by checking the last bit of the BiDi level. If it's 1, the character is RTL, otherwise the character is LTR. The BiDi level of a character must be in the range of [0, 125].

setCharacterBounds

public TextBoundsInfo.Builder setCharacterBounds (float[] characterBounds)

Set the characters bounds, in the coordinates of the editor.
The given array should be divided into groups of four where each element represents left, top, right and bottom of the character bounds respectively. The bounds of the i-th character in the editor should be stored at index 4 * (i - start). The length of the given array must equal to 4 * (end - start).
Sometimes multiple characters in a single grapheme are rendered as one symbol on the screen. So those characters only have one shared bounds. In this case, we recommend the editor to assign all the width to the bounds of the first character in the grapheme, and make the rest characters' bounds zero-width.
For example, the string "'0xD83D' '0xDE00'" is rendered as one grapheme - a grinning face emoji. If the bounds of the grapheme is: Rect(5, 10, 15, 20), the character bounds of the string should be: [ Rect(5, 10, 15, 20), Rect(15, 10, 15, 20) ].

setCharacterFlags

public TextBoundsInfo.Builder setCharacterFlags (int[] characterFlags)

Set the flags of the characters. The flags of the i-th character in the editor is stored at index (i - start). The length of the given array must equal to (end - start). The flags contain the following information:

• The TextBoundsInfo.FLAG_CHARACTER_WHITESPACE flag, indicating the character is a whitespace.
• The TextBoundsInfo.FLAG_CHARACTER_LINEFEED flag, indicating the character is a linefeed.
• The TextBoundsInfo.FLAG_CHARACTER_PUNCTUATION flag, indicating the character is a punctuation.
• The TextBoundsInfo.FLAG_LINE_IS_RTL flag, indicating the line this character belongs to is RTL. All all character in the same line must have the same line direction. Check TextBoundsInfo.getLineSegmentFinder() for more information of line boundaries.

setGraphemeSegmentFinder

public TextBoundsInfo.Builder setGraphemeSegmentFinder (SegmentFinder graphemeSegmentFinder)

Set the SegmentFinder that locates the grapheme cluster boundaries. Grapheme is defined in the unicode annex #29: unicode text segmentation. It's a user-perspective character. And it's usually the minimal unit for selection, backspace, deletion etc.
Please note that only the grapheme segments within the range from start to end will be available to the IME. The remaining information will be discarded during serialization for better performance.

setLineSegmentFinder

public TextBoundsInfo.Builder setLineSegmentFinder (SegmentFinder lineSegmentFinder)

Set the SegmentFinder that locates the line boundaries. Aside from the hard breaks in the text, it should also locate the soft line breaks added by the editor. It is expected that the characters within the same line is rendered on the same baseline. (Except for some text formatted as subscript and superscript.)
Please note that only the line segments within the range from start to end will be available to the IME. The remaining information will be discarded during serialization for better performance.

setMatrix

public TextBoundsInfo.Builder setMatrix (Matrix matrix)

Sets the matrix that transforms local coordinates into screen coordinates.

setStartAndEnd

public TextBoundsInfo.Builder setStartAndEnd (int start, 
                int end)

Set the start and end index of the TextBoundsInfo. It's the range of the characters whose information is available in the TextBoundsInfo.

setWordSegmentFinder

public TextBoundsInfo.Builder setWordSegmentFinder (SegmentFinder wordSegmentFinder)

Set the SegmentFinder that locates the word boundaries.
Please note that only the word segments within the range from start to end will be available to the IME. The remaining information will be discarded during serialization for better performance.