# RouteListingPreference.Item.Builder

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

# Builder

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/media/RouteListingPreference.Item.Builder "View this page in Java")  

```
class Builder
```

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

Builder for[Item](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item).

## Summary

|                                                                                                                 Public constructors                                                                                                                 ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [Builder](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#Builder(kotlin.String))`(`routeId:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)`)` Constructor. |

|                                                                                                                                                                                                                                                                                             Public methods                                                                                                                                                                                                                                                                                              ||
|------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [RouteListingPreference.Item](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item)                  | [build](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#build())`()` Creates and returns a new[Item](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item)with the given parameters.                                                                                                                                                                                     |
| [RouteListingPreference.Item.Builder](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#) | [setCustomSubtextMessage](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#setCustomSubtextMessage(kotlin.CharSequence))`(`customSubtextMessage:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?`)` See[Item.getCustomSubtextMessage()](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#getCustomSubtextMessage()). |
| [RouteListingPreference.Item.Builder](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#) | [setFlags](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#setFlags(kotlin.Int))`(`flags:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` See[Item.getFlags()](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#getFlags()).                                                                                                         |
| [RouteListingPreference.Item.Builder](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#) | [setSelectionBehavior](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#setSelectionBehavior(kotlin.Int))`(`selectionBehavior:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` See[Item.getSelectionBehavior()](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#getSelectionBehavior()).                                             |
| [RouteListingPreference.Item.Builder](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#) | [setSubText](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#setSubText(kotlin.Int))`(`subText:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` See[Item.getSubText()](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#getSubText()).                                                                                               |

## Public constructors

### Builder

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

```
Builder(routeId: String)
```

Constructor.

|                                                                                                                       Parameters                                                                                                                       ||
|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `routeId` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html):See[Item.getRouteId()](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#getRouteId()). This value cannot be`null`. |

## Public methods

### build

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

```
fun build(): RouteListingPreference.Item
```

Creates and returns a new[Item](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item)with the given parameters.

|                                                                        Return                                                                        ||
|-------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [RouteListingPreference.Item](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item) | This value cannot be`null`. |

### setCustomSubtextMessage

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

```
fun setCustomSubtextMessage(customSubtextMessage: CharSequence?): RouteListingPreference.Item.Builder
```

See[Item.getCustomSubtextMessage()](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#getCustomSubtextMessage()).

The default value is`null`.

|                                                                   Parameters                                                                    ||
|------------------------|-------------------------------------------------------------------------------------------------------------------------|
| `customSubtextMessage` | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?:This value may be`null`. |

### setFlags

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

```
fun setFlags(flags: Int): RouteListingPreference.Item.Builder
```

See[Item.getFlags()](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#getFlags()).

The default value is zero (no flags).

|                                                                                Return                                                                                 ||
|------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [RouteListingPreference.Item.Builder](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#) | This value cannot be`null`. |

### setSelectionBehavior

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

```
fun setSelectionBehavior(selectionBehavior: Int): RouteListingPreference.Item.Builder
```

See[Item.getSelectionBehavior()](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#getSelectionBehavior()).

The default value is[ACTION_TRANSFER_MEDIA](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference#ACTION_TRANSFER_MEDIA:kotlin.String).

|                                                                                Return                                                                                 ||
|------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [RouteListingPreference.Item.Builder](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#) | This value cannot be`null`. |

### setSubText

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

```
fun setSubText(subText: Int): RouteListingPreference.Item.Builder
```

See[Item.getSubText()](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#getSubText()).

The default value is[SUBTEXT_NONE](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item#SUBTEXT_NONE:kotlin.Int).

|                                                                                Return                                                                                 ||
|------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [RouteListingPreference.Item.Builder](https://developer.android.com/reference/kotlin/android/media/RouteListingPreference.Item.Builder#) | This value cannot be`null`. |