Added in API level 34

Builder


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

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

Summary

Public constructors

Public methods
SelectGesture

SelectGesture.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.

SelectGesture.Builder
setGranularity(granularity: Int)

Define text selection granularity.

SelectGesture.Builder

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

Public constructors

Builder

Builder()

Public methods

build

Added in API level 34
fun build(): SelectGesture
Return
SelectGesture SelectGesture using parameters in this 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?): SelectGesture.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
SelectGesture.Builder This value cannot be null.

setGranularity

Added in API level 34
fun setGranularity(granularity: Int): SelectGesture.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
SelectGesture.Builder Builder. This value cannot be null.

setSelectionArea

Added in API level 34
fun setSelectionArea(area: RectF): SelectGesture.Builder

Set rectangular single/multiline text selection area intersecting with text. The resulting selection would be performed for all text intersecting rectangle. The selection includes the first word/character in the rectangle, and the last word/character in the rectangle, and includes 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
area RectF: RectF (in screen coordinates) for which text will be selection. This value cannot be null.
Return
SelectGesture.Builder This value cannot be null.