Added in API level 34

Builder

class Builder
kotlin.Any
   ↳ android.view.inputmethod.SelectRangeGesture.Builder

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

Summary

Public constructors

Public methods
SelectRangeGesture

SelectRangeGesture.Builder
setFallbackText(fallbackText: String?)

Set fallback text that will be committed at current cursor position if there is no applicable text beneath the area of gesture.
SelectRangeGesture.Builder
setGranularity(granularity: Int)

Define text selection granularity.
SelectRangeGesture.Builder

Set rectangular single/multiline end of text selection area intersecting with text.
SelectRangeGesture.Builder

Set rectangular single/multiline start of text selection area intersecting with text.

Public constructors

Builder

Builder()

Public methods

build

Added in API level 34
fun build(): SelectRangeGesture
Return
SelectRangeGesture SelectRangeGesture using parameters in this SelectRangeGesture.Builder. This value cannot be null.
Exceptions
java.lang.IllegalArgumentException if one or more positional parameters are not specified.

setFallbackText

Added in API level 34
fun setFallbackText(fallbackText: String?): SelectRangeGesture.Builder

Set fallback text that will be committed at current cursor position if there is no applicable text beneath the area of gesture.

Parameters
fallbackText String?: text to set This value may be null.
Return
SelectRangeGesture.Builder This value cannot be null.

setGranularity

Added in API level 34
fun setGranularity(granularity: Int): SelectRangeGesture.Builder

Define text selection granularity. Intersecting words/characters will be included in the operation.

Parameters
granularity Int: HandwritingGesture#GRANULARITY_WORD or HandwritingGesture#GRANULARITY_CHARACTER. Value is android.view.inputmethod.HandwritingGesture#GRANULARITY_CHARACTER, or android.view.inputmethod.HandwritingGesture#GRANULARITY_WORD
Return
SelectRangeGesture.Builder Builder. This value cannot be null.

setSelectionEndArea

Added in API level 34
fun setSelectionEndArea(endArea: RectF): SelectRangeGesture.Builder

Set rectangular single/multiline end of text selection area intersecting with text. The resulting selection is performed from the start of first word/character in the start rectangle setSelectionStartArea(android.graphics.RectF) to the end of the last word/character in the end rectangle.

The selection includes the first word/character in the rectangle, the last word/character in the rectangle, and everything in between even if it's not in the rectangle. Intersection is determined using setGranularity(int). e.g. HandwritingGesture#GRANULARITY_WORD includes all the words with their width/height center included in the selection rectangle.

Parameters
endArea RectF: RectF (in screen coordinates) for start of selection. This rectangle belongs to the last line where selection should end. This value cannot be null.
Return
SelectRangeGesture.Builder This value cannot be null.

setSelectionStartArea

Added in API level 34
fun setSelectionStartArea(startArea: RectF): SelectRangeGesture.Builder

Set rectangular single/multiline start of text selection area intersecting with text. The resulting selection is performed from the start of first word/character in the start rectangle to the end of the last word/character in the end rectangle setSelectionEndArea(android.graphics.RectF).

Intersection is determined using setGranularity(int). e.g. HandwritingGesture#GRANULARITY_WORD includes all the words with their width/height center included in the selection rectangle.

Parameters
startArea RectF: RectF (in screen coordinates) for start of selection. This rectangle belongs to first line where selection should start. This value cannot be null.
Return
SelectRangeGesture.Builder This value cannot be null.