Android APIs
public static final class

CursorAnchorInfo.Builder

extends Object
java.lang.Object
   ↳ android.view.inputmethod.CursorAnchorInfo.Builder

Class Overview

Builder for CursorAnchorInfo. This class is not designed to be thread-safe.

Summary

Public Constructors
CursorAnchorInfo.Builder()
Public Methods
CursorAnchorInfo.Builder addCharacterBounds(int index, float left, float top, float right, float bottom, int flags)
Adds the bounding box of the character specified with the index.
CursorAnchorInfo build()
void reset()
Resets the internal state so that this instance can be reused to build another instance of CursorAnchorInfo.
CursorAnchorInfo.Builder setComposingText(int composingTextStart, CharSequence composingText)
Sets the text range of the composing text.
CursorAnchorInfo.Builder setInsertionMarkerLocation(float horizontalPosition, float lineTop, float lineBaseline, float lineBottom, int flags)
Sets the location of the text insertion point (zero width cursor) as a rectangle in local coordinates.
CursorAnchorInfo.Builder setMatrix(Matrix matrix)
Sets the matrix that transforms local coordinates into screen coordinates.
CursorAnchorInfo.Builder setSelectionRange(int newStart, int newEnd)
Sets the text range of the selection.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public CursorAnchorInfo.Builder ()

Added in API level 21

Public Methods

public CursorAnchorInfo.Builder addCharacterBounds (int index, float left, float top, float right, float bottom, int flags)

Added in API level 21

Adds the bounding box of the character specified with the index.

Parameters
index index of the character in Java chars units. Must be specified in ascending order across successive calls.
left x coordinate of the left edge of the character in local coordinates.
top y coordinate of the top edge of the character in local coordinates.
right x coordinate of the right edge of the character in local coordinates.
bottom y coordinate of the bottom edge of the character in local coordinates.
flags flags for this character bounds. See FLAG_HAS_VISIBLE_REGION, FLAG_HAS_INVISIBLE_REGION and FLAG_IS_RTL. These flags must be specified when necessary.
Throws
IllegalArgumentException If the index is a negative value, or not greater than all of the previously called indices.

public CursorAnchorInfo build ()

Added in API level 21

Returns
Throws
IllegalArgumentException if one or more positional parameters are specified but the coordinate transformation matrix is not provided via setMatrix(Matrix).

public void reset ()

Added in API level 21

Resets the internal state so that this instance can be reused to build another instance of CursorAnchorInfo.

public CursorAnchorInfo.Builder setComposingText (int composingTextStart, CharSequence composingText)

Added in API level 21

Sets the text range of the composing text. Calling this can be skipped if there is no composing text.

Parameters
composingTextStart index where the composing text starts.
composingText the entire composing text.

public CursorAnchorInfo.Builder setInsertionMarkerLocation (float horizontalPosition, float lineTop, float lineBaseline, float lineBottom, int flags)

Added in API level 21

Sets the location of the text insertion point (zero width cursor) as a rectangle in local coordinates. Calling this can be skipped when there is no text insertion point; however if there is an insertion point, editors must call this method.

Parameters
horizontalPosition horizontal position of the insertion marker, in the local coordinates that will be transformed with the transformation matrix when rendered on the screen. This should be calculated or compatible with getPrimaryHorizontal(int).
lineTop vertical position of the insertion marker, in the local coordinates that will be transformed with the transformation matrix when rendered on the screen. This should be calculated or compatible with getLineTop(int).
lineBaseline vertical position of the insertion marker, in the local coordinates that will be transformed with the transformation matrix when rendered on the screen. This should be calculated or compatible with getLineBaseline(int).
lineBottom vertical position of the insertion marker, in the local coordinates that will be transformed with the transformation matrix when rendered on the screen. This should be calculated or compatible with getLineBottom(int).
flags flags of the insertion marker. See FLAG_HAS_VISIBLE_REGION for example.

public CursorAnchorInfo.Builder setMatrix (Matrix matrix)

Added in API level 21

Sets the matrix that transforms local coordinates into screen coordinates.

Parameters
matrix transformation matrix from local coordinates into screen coordinates. null is interpreted as an identity matrix.

public CursorAnchorInfo.Builder setSelectionRange (int newStart, int newEnd)

Added in API level 21

Sets the text range of the selection. Calling this can be skipped if there is no selection.