# TextSelection.Request.Builder

Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# Builder

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/view/textclassifier/TextSelection.Request.Builder "View this page in Java")  

```
class Builder
```

|---|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                                                         ||
| ↳ | [android.view.textclassifier.TextSelection.Request.Builder](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#) |

A builder for building TextSelection requests.

## Summary

|                                                                                                                                                                                                                                   Public constructors                                                                                                                                                                                                                                   ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [Builder](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#Builder(kotlin.CharSequence,%20kotlin.Int,%20kotlin.Int))`(`text:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)`, `startIndex:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`, `endIndex:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` <br /> |

|                                                                                                                                                                                                                        Public methods                                                                                                                                                                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [TextSelection.Request](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request)                  | [build](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#build())`()` Builds and returns the request object.                                                                                                                                              |
| [TextSelection.Request.Builder](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#) | [setDefaultLocales](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#setDefaultLocales(android.os.LocaleList))`(`defaultLocales:` `[LocaleList](https://developer.android.com/reference/kotlin/android/os/LocaleList.html#)?`)` <br />                    |
| [TextSelection.Request.Builder](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#) | [setExtras](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#setExtras(android.os.Bundle))`(`extras:` `[Bundle](https://developer.android.com/reference/kotlin/android/os/Bundle.html#)?`)` Sets the extended data.                                       |
| [TextSelection.Request.Builder](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#) | [setIncludeTextClassification](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#setIncludeTextClassification(kotlin.Boolean))`(`includeTextClassification:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` <br /> |

## Public constructors

### Builder

Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
Builder(
    text: CharSequence, 
    startIndex: Int, 
    endIndex: Int)
```

|                                                                                                                                          Parameters                                                                                                                                           ||
|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `text`       | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html):text providing context for the selected text (which is specified by the sub sequence starting at selectionStartIndex and ending at selectionEndIndex) This value cannot be`null`. |
| `startIndex` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):start index of the selected part of text Value is 0 or greater                                                                                                                                       |
| `endIndex`   | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):end index of the selected part of text Value is 0 or greater                                                                                                                                         |

## Public methods

### build

Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun build(): TextSelection.Request
```

Builds and returns the request object.

|                                                                         Return                                                                         ||
|---------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [TextSelection.Request](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request) | This value cannot be`null`. |

### setDefaultLocales

Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun setDefaultLocales(defaultLocales: LocaleList?): TextSelection.Request.Builder
```

|                                                                                                                                  Parameters                                                                                                                                  ||
|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `defaultLocales` | [LocaleList](https://developer.android.com/reference/kotlin/android/os/LocaleList.html#)?:ordered list of locale preferences that may be used to disambiguate the provided text. If no locale preferences exist, set this to null or an empty locale list. |

|                                                                                        Return                                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------|
| [TextSelection.Request.Builder](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#) | this builder. This value cannot be`null`. |

### setExtras

Added in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun setExtras(extras: Bundle?): TextSelection.Request.Builder
```

Sets the extended data.

|                                                      Parameters                                                      ||
|----------|------------------------------------------------------------------------------------------------------------|
| `extras` | [Bundle](https://developer.android.com/reference/kotlin/android/os/Bundle.html#)?:This value may be`null`. |

|                                                                                        Return                                                                                        ||
|--------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------|
| [TextSelection.Request.Builder](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#) | this builder This value cannot be`null`. |

### setIncludeTextClassification

Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun setIncludeTextClassification(includeTextClassification: Boolean): TextSelection.Request.Builder
```

|                                                                                                                                                                                                                                             Parameters                                                                                                                                                                                                                                             ||
|-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `includeTextClassification` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html):If true, suggests the TextClassifier to classify the text in the suggested selection span and include a TextClassification object in the result. The TextClassifier may not support this and in which case,[TextSelection.getTextClassification()](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection#getTextClassification())returns`null`. |

|                                                                                        Return                                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------|
| [TextSelection.Request.Builder](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection.Request.Builder#) | this builder. This value cannot be`null`. |

**See Also**

- [android.view.textclassifier.TextSelection#getTextClassification()](https://developer.android.com/reference/kotlin/android/view/textclassifier/TextSelection#getTextClassification())