# RangedValueComplicationData.Builder

Artifact: [androidx.wear.watchface:watchface-complications-data](https://developer.android.com/jetpack/androidx/releases/wear-watchface) [View Source](https://cs.android.com/search?q=file:androidx/wear/watchface/complications/data/Data.kt+class:androidx.wear.watchface.complications.data.RangedValueComplicationData.Builder) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

*** ** * ** ***

<br />

```
class RangedValueComplicationData.Builder
```

<br />

*** ** * ** ***

Builder for `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData`.

You must at a minimum set the `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#min()`, `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#max()` and `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#contentDescription()` fields, at least one of `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#value()` or `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#dynamicValue()`, and at least one of `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#monochromaticImage()`, `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#smallImage()`, `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#text()` or `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#title()`.

## Summary

| ### Public constructors |
|---|
| `@https://developer.android.com/reference/kotlin/androidx/annotation/RequiresApi(value = 34) https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#Builder(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)( dynamicValue: https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat, min: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html, max: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html, contentDescription: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ComplicationText )` Creates a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` for a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData` with a `https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat` value, and no `fallbackValue` for API levels known to support dynamic values. |
| `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#Builder(kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)( value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html, min: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html, max: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html, contentDescription: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ComplicationText )` Creates a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` for a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData` with a `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` value. |
| `@https://developer.android.com/reference/kotlin/androidx/annotation/RequiresApi(value = 33) https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#Builder(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)( dynamicValue: https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat, fallbackValue: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html, min: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html, max: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html, contentDescription: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ComplicationText )` Creates a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` for a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData` with a `https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat` value. |

| ### Public functions |
|---|---|
| `open https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData` | `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#build()()` Builds the `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData`. |
| `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setColorRamp(androidx.wear.watchface.complications.data.ColorRamp)(colorRamp: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ColorRamp?)` Sets an optional hint that the renderer should draw the progress bar using the `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ColorRamp`. |
| `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setMonochromaticImage(androidx.wear.watchface.complications.data.MonochromaticImage)(monochromaticImage: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/MonochromaticImage?)` Sets optional icon associated with the complication data. |
| `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setSmallImage(androidx.wear.watchface.complications.data.SmallImage)(smallImage: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/SmallImage?)` Sets optional image associated with the complication data. |
| `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setTapAction(android.app.PendingIntent)(tapAction: https://developer.android.com/reference/android/app/PendingIntent.html?)` Sets optional pending intent to be invoked when the complication is tapped. |
| `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setText(androidx.wear.watchface.complications.data.ComplicationText)(text: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ComplicationText?)` Sets optional text associated with the complication data. |
| `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setTitle(androidx.wear.watchface.complications.data.ComplicationText)(title: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ComplicationText?)` Sets optional title associated with the complication data. |
| `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValidTimeRange(androidx.wear.watchface.complications.data.TimeRange)(validTimeRange: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/TimeRange?)` Sets optional time range during which the complication has to be shown. |
| `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValueType(kotlin.Int)(valueType: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Sets the semantic meaning of `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#value()`. |

## Public constructors

### Builder

Added in [1.3.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.3.0)

```
@RequiresApi(value = 34)
Builder(
    dynamicValue: DynamicBuilders.DynamicFloat,
    min: Float,
    max: Float,
    contentDescription: ComplicationText
)
```

Creates a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` for a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData` with a `https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat` value, and no `fallbackValue` for API levels known to support dynamic values.

| Parameters |
|---|---|
| `dynamicValue: https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat` | The `https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat` of the ranged complication which will be evaluated into a value dynamically, and should be in the range \[`https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`\] .. \[`https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`\]. The semantic meaning of value can be specified via `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValueType(kotlin.Int)`. |
| `min: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | The minimum value. For `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `max: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | The maximum value. This must be less than `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/-companion/-m-a-x_-v-a-l-u-e.html`. For `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `contentDescription: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ComplicationText` | Defines localized text that briefly describes content of the complication. This property is used primarily for accessibility. Since some complications do not have textual representation this attribute can be used for providing such. Please do not include the word 'complication' in the description. |

### Builder

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

```
Builder(
    value: Float,
    min: Float,
    max: Float,
    contentDescription: ComplicationText
)
```

Creates a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` for a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData` with a `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` value.

| Parameters |
|---|---|
| `value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | The value of the ranged complication which should be in the range \[`https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`\] .. \[`https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`\]. The semantic meaning of value can be specified via `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValueType(kotlin.Int)`. |
| `min: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | The minimum value. For `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `max: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | The maximum value. This must be less than `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/-companion/-m-a-x_-v-a-l-u-e.html`. For `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `contentDescription: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ComplicationText` | Defines localized text that briefly describes content of the complication. This property is used primarily for accessibility. Since some complications do not have textual representation this attribute can be used for providing such. Please do not include the word 'complication' in the description. |

### Builder

Added in [1.2.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.2.0)

```
@RequiresApi(value = 33)
Builder(
    dynamicValue: DynamicBuilders.DynamicFloat,
    fallbackValue: Float,
    min: Float,
    max: Float,
    contentDescription: ComplicationText
)
```

Creates a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` for a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData` with a `https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat` value.

| Parameters |
|---|---|
| `dynamicValue: https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat` | The `https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat` of the ranged complication which will be evaluated into a value dynamically, and should be in the range \[`https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`\] .. \[`https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`\]. The semantic meaning of value can be specified via `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValueType(kotlin.Int)`. |
| `fallbackValue: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | The fallback value of the ranged complication used on systems that don't support `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`, which should be in the range \[`https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`\] .. \[`https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`\]. The semantic meaning of value can be specified via `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValueType(kotlin.Int)`. This is only relevant before `https://developer.android.com/reference/android/os/Build.VERSION_CODES.html#UPSIDE_DOWN_CAKE`, use the no-fallback constructor if you target an equal or higher API level. IMPORTANT: This is only used when the system does not support `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)` *at all* . See `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setDynamicValueInvalidationFallback(androidx.wear.watchface.complications.data.RangedValueComplicationData)` for the situation where `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(androidx.wear.protolayout.expression.DynamicBuilders.DynamicFloat,kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)` cannot be evaluated, e.g. when a data source is not available. |
| `min: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | The minimum value. For `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `max: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html` | The maximum value. This must be less than `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/-companion/-m-a-x_-v-a-l-u-e.html`. For `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `contentDescription: https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ComplicationText` | Defines localized text that briefly describes content of the complication. This property is used primarily for accessibility. Since some complications do not have textual representation this attribute can be used for providing such. Please do not include the word 'complication' in the description. |

## Public functions

### build

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

```
open fun build(): RangedValueComplicationData
```

Builds the `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData`.

### setColorRamp

Added in [1.2.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.2.0)

```
fun setColorRamp(colorRamp: ColorRamp?): RangedValueComplicationData.Builder
```

Sets an optional hint that the renderer should draw the progress bar using the `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/ColorRamp`.

### setMonochromaticImage

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

```
fun setMonochromaticImage(monochromaticImage: MonochromaticImage?): RangedValueComplicationData.Builder
```

Sets optional icon associated with the complication data.

### setSmallImage

Added in [1.2.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.2.0)

```
fun setSmallImage(smallImage: SmallImage?): RangedValueComplicationData.Builder
```

Sets optional image associated with the complication data.

### setTapAction

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

```
fun setTapAction(tapAction: PendingIntent?): RangedValueComplicationData.Builder
```

Sets optional pending intent to be invoked when the complication is tapped.

### setText

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

```
fun setText(text: ComplicationText?): RangedValueComplicationData.Builder
```

Sets optional text associated with the complication data.

### setTitle

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

```
fun setTitle(title: ComplicationText?): RangedValueComplicationData.Builder
```

Sets optional title associated with the complication data.

### setValidTimeRange

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

```
fun setValidTimeRange(validTimeRange: TimeRange?): RangedValueComplicationData.Builder
```

Sets optional time range during which the complication has to be shown.

### setValueType

Added in [1.2.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.2.0)

```
fun setValueType(valueType: Int): RangedValueComplicationData.Builder
```

Sets the semantic meaning of `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#value()`. The complication renderer may choose to visually differentiate between the different types, for example rendering a dot on a line/arc to indicate the value for a `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_RATING()`. Defaults to `https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_UNDEFINED()` if not set.