# 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 />

```
public final class RangedValueComplicationData.Builder
```

<br />

*** ** * ** ***

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

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

## Summary

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

| ### Public methods |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData` | `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#build()()` Builds the `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData`. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setColorRamp(androidx.wear.watchface.complications.data.ColorRamp)(https://developer.android.com/reference/androidx/wear/watchface/complications/data/ColorRamp colorRamp)` Sets an optional hint that the renderer should draw the progress bar using the `https://developer.android.com/reference/androidx/wear/watchface/complications/data/ColorRamp`. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setMonochromaticImage(androidx.wear.watchface.complications.data.MonochromaticImage)(https://developer.android.com/reference/androidx/wear/watchface/complications/data/MonochromaticImage monochromaticImage)` Sets optional icon associated with the complication data. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setSmallImage(androidx.wear.watchface.complications.data.SmallImage)(https://developer.android.com/reference/androidx/wear/watchface/complications/data/SmallImage smallImage)` Sets optional image associated with the complication data. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setTapAction(android.app.PendingIntent)(https://developer.android.com/reference/android/app/PendingIntent.html tapAction)` Sets optional pending intent to be invoked when the complication is tapped. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setText(androidx.wear.watchface.complications.data.ComplicationText)(https://developer.android.com/reference/androidx/wear/watchface/complications/data/ComplicationText text)` Sets optional text associated with the complication data. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setTitle(androidx.wear.watchface.complications.data.ComplicationText)(https://developer.android.com/reference/androidx/wear/watchface/complications/data/ComplicationText title)` Sets optional title associated with the complication data. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValidTimeRange(androidx.wear.watchface.complications.data.TimeRange)(https://developer.android.com/reference/androidx/wear/watchface/complications/data/TimeRange validTimeRange)` Sets optional time range during which the complication has to be shown. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder` | `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValueType(kotlin.Int)(int valueType)` Sets the semantic meaning of `https://developer.android.com/reference/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)
public Builder(
    @NonNull DynamicBuilders.DynamicFloat dynamicValue,
    float min,
    float max,
    @NonNull ComplicationText contentDescription
)
```

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

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat dynamicValue` | The `https://developer.android.com/reference/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/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/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/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValueType(kotlin.Int)`. |
| `float min` | The minimum value. For `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `float max` | 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/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/ComplicationText contentDescription` | 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)

```
public Builder(
    float value,
    float min,
    float max,
    @NonNull ComplicationText contentDescription
)
```

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

| Parameters |
|---|---|
| `float value` | The value of the ranged complication which should be in the range \[`https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#(kotlin.Float,kotlin.Float,kotlin.Float,androidx.wear.watchface.complications.data.ComplicationText)`\] .. \[`https://developer.android.com/reference/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/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValueType(kotlin.Int)`. |
| `float min` | The minimum value. For `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `float max` | 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/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/ComplicationText contentDescription` | 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)
public Builder(
    @NonNull DynamicBuilders.DynamicFloat dynamicValue,
    float fallbackValue,
    float min,
    float max,
    @NonNull ComplicationText contentDescription
)
```

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

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/protolayout/expression/DynamicBuilders.DynamicFloat dynamicValue` | The `https://developer.android.com/reference/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/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/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/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setValueType(kotlin.Int)`. |
| `float fallbackValue` | The fallback value of the ranged complication used on systems that don't support `https://developer.android.com/reference/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/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/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/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/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/androidx/wear/watchface/complications/data/RangedValueComplicationData.Builder#setDynamicValueInvalidationFallback(androidx.wear.watchface.complications.data.RangedValueComplicationData)` for the situation where `https://developer.android.com/reference/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. |
| `float min` | The minimum value. For `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `float max` | 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/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_PERCENTAGE()` this must be 0f. |
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/wear/watchface/complications/data/ComplicationText contentDescription` | 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 methods

### build

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

```
public @NonNull RangedValueComplicationData build()
```

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

### setColorRamp

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

```
public final @NonNull RangedValueComplicationData.Builder setColorRamp(ColorRamp colorRamp)
```

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

### setMonochromaticImage

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

```
public final @NonNull RangedValueComplicationData.Builder setMonochromaticImage(MonochromaticImage monochromaticImage)
```

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)

```
public final @NonNull RangedValueComplicationData.Builder setSmallImage(SmallImage smallImage)
```

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)

```
public final @NonNull RangedValueComplicationData.Builder setTapAction(PendingIntent tapAction)
```

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)

```
public final @NonNull RangedValueComplicationData.Builder setText(ComplicationText text)
```

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)

```
public final @NonNull RangedValueComplicationData.Builder setTitle(ComplicationText title)
```

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)

```
public final @NonNull RangedValueComplicationData.Builder setValidTimeRange(TimeRange validTimeRange)
```

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)

```
public final @NonNull RangedValueComplicationData.Builder setValueType(int valueType)
```

Sets the semantic meaning of `https://developer.android.com/reference/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/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_RATING()`. Defaults to `https://developer.android.com/reference/androidx/wear/watchface/complications/data/RangedValueComplicationData#TYPE_UNDEFINED()` if not set.