Builder

Kotlin |Java

class Builder

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

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

Summary

Public constructors
`Builder()`

Public methods
SelectRangeGesture	`build()`
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	`setSelectionEndArea(endArea: RectF)` Set rectangular single/multiline end of text selection area intersecting with text.
SelectRangeGesture.Builder	`setSelectionStartArea(startArea: RectF)` 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`.