# RangeTemplate

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

# RangeTemplate

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/service/controls/templates/RangeTemplate "View this page in Java")  

```
class RangeTemplate : ControlTemplate
```

|---|---|------------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                                          |||
| ↳ | [android.service.controls.templates.ControlTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate) ||
|   | ↳ | [android.service.controls.templates.RangeTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#) |

A template for a[Control](https://developer.android.com/reference/kotlin/android/service/controls/Control.html#)with inputs in a "continuous" range of values.

## Summary

| Inherited constants ||
|---|---|
| From class[ControlTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate) |----------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [TYPE_ERROR](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_ERROR:kotlin.Int) <br /> Type identifier of the template returned by[getErrorTemplate()](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#getErrorTemplate()). Value is[android.service.controls.templates.ControlTemplate#TYPE_ERROR](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_ERROR:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_NO_TEMPLATE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_NO_TEMPLATE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_THUMBNAIL](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_THUMBNAIL:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TEMPERATURE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TEMPERATURE:kotlin.Int), or[android.service.controls.templates.ControlTemplate#TYPE_STATELESS](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_STATELESS:kotlin.Int) <br />        | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [TYPE_NO_TEMPLATE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_NO_TEMPLATE:kotlin.Int) <br /> Type identifier of[ControlTemplate.getNoTemplateObject](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#getNoTemplateObject()). Value is[android.service.controls.templates.ControlTemplate#TYPE_ERROR](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_ERROR:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_NO_TEMPLATE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_NO_TEMPLATE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_THUMBNAIL](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_THUMBNAIL:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TEMPERATURE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TEMPERATURE:kotlin.Int), or[android.service.controls.templates.ControlTemplate#TYPE_STATELESS](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_STATELESS:kotlin.Int) <br /> | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int) <br /> Type identifier of[RangeTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#). Value is[android.service.controls.templates.ControlTemplate#TYPE_ERROR](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_ERROR:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_NO_TEMPLATE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_NO_TEMPLATE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_THUMBNAIL](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_THUMBNAIL:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TEMPERATURE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TEMPERATURE:kotlin.Int), or[android.service.controls.templates.ControlTemplate#TYPE_STATELESS](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_STATELESS:kotlin.Int) <br />                                                          | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [TYPE_STATELESS](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_STATELESS:kotlin.Int) <br /> Type identifier of[StatelessTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/StatelessTemplate). Value is[android.service.controls.templates.ControlTemplate#TYPE_ERROR](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_ERROR:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_NO_TEMPLATE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_NO_TEMPLATE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_THUMBNAIL](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_THUMBNAIL:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TEMPERATURE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TEMPERATURE:kotlin.Int), or[android.service.controls.templates.ControlTemplate#TYPE_STATELESS](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_STATELESS:kotlin.Int) <br />                                           | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [TYPE_TEMPERATURE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TEMPERATURE:kotlin.Int) <br /> Type identifier of[TemperatureControlTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/TemperatureControlTemplate). Value is[android.service.controls.templates.ControlTemplate#TYPE_ERROR](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_ERROR:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_NO_TEMPLATE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_NO_TEMPLATE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_THUMBNAIL](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_THUMBNAIL:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TEMPERATURE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TEMPERATURE:kotlin.Int), or[android.service.controls.templates.ControlTemplate#TYPE_STATELESS](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_STATELESS:kotlin.Int) <br />                     | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [TYPE_THUMBNAIL](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_THUMBNAIL:kotlin.Int) <br /> Type identifier of[ThumbnailTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ThumbnailTemplate). Value is[android.service.controls.templates.ControlTemplate#TYPE_ERROR](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_ERROR:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_NO_TEMPLATE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_NO_TEMPLATE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_THUMBNAIL](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_THUMBNAIL:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TEMPERATURE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TEMPERATURE:kotlin.Int), or[android.service.controls.templates.ControlTemplate#TYPE_STATELESS](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_STATELESS:kotlin.Int) <br />                                           | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [TYPE_TOGGLE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE:kotlin.Int) <br /> Type identifier of[ToggleTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ToggleTemplate). Value is[android.service.controls.templates.ControlTemplate#TYPE_ERROR](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_ERROR:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_NO_TEMPLATE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_NO_TEMPLATE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_THUMBNAIL](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_THUMBNAIL:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TEMPERATURE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TEMPERATURE:kotlin.Int), or[android.service.controls.templates.ControlTemplate#TYPE_STATELESS](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_STATELESS:kotlin.Int) <br />                                                       | | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [TYPE_TOGGLE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE_RANGE:kotlin.Int) <br /> Type identifier of[ToggleRangeTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ToggleRangeTemplate). Value is[android.service.controls.templates.ControlTemplate#TYPE_ERROR](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_ERROR:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_NO_TEMPLATE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_NO_TEMPLATE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_THUMBNAIL](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_THUMBNAIL:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TOGGLE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TOGGLE_RANGE:kotlin.Int),[android.service.controls.templates.ControlTemplate#TYPE_TEMPERATURE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_TEMPERATURE:kotlin.Int), or[android.service.controls.templates.ControlTemplate#TYPE_STATELESS](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_STATELESS:kotlin.Int) <br />                                 | ||

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     Public constructors                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      ||
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [RangeTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#RangeTemplate(kotlin.String,%20kotlin.Float,%20kotlin.Float,%20kotlin.Float,%20kotlin.Float,%20kotlin.CharSequence))`(`templateId:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)`, `minValue:` `[Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)`, `maxValue:` `[Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)`, `currentValue:` `[Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)`, `stepValue:` `[Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)`, `formatString:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?`)` Construct a new[RangeTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#). |

|                                                                                                                                                                                                                                                                   Public methods                                                                                                                                                                                                                                                                    ||
|-----------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)                | [getCurrentValue](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#getCurrentValue())`()` The current value for this range.                                                                                                                                                                                                                                                                           |
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html) | [getFormatString](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#getFormatString())`()` Formatter for generating a user visible[String](https://developer.android.com/reference/kotlin/java/lang/String.html#)representing the value returned by[RangeTemplate.getCurrentValue](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#getCurrentValue()). |
| [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)                | [getMaxValue](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#getMaxValue())`()` The maximum value for this range.                                                                                                                                                                                                                                                                                   |
| [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)                | [getMinValue](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#getMinValue())`()` The minimum value for this range.                                                                                                                                                                                                                                                                                   |
| [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)                | [getStepValue](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#getStepValue())`()` The value of the smallest increment or decrement that can be performed on this range.                                                                                                                                                                                                                             |
| [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)                    | [getTemplateType](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#getTemplateType())`()` <br />                                                                                                                                                                                                                                                                                                      |

| Inherited functions ||
|---|---|
| From class[ControlTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate) |----------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [ControlTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate) | [getErrorTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#getErrorTemplate())`()` <br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | | [ControlTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate) | [getNoTemplateObject](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#getNoTemplateObject())`()` <br /> Get a singleton[ControlTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate), which supports no direct user input. Used by[Control.StatelessBuilder](https://developer.android.com/reference/kotlin/android/service/controls/Control.StatelessBuilder.html#)when there is no known state. Can also be used in[Control.StatefulBuilder](https://developer.android.com/reference/kotlin/android/service/controls/Control.StatefulBuilder.html#)for conveying information to a user about the[Control](https://developer.android.com/reference/kotlin/android/service/controls/Control.html#)but direct user interaction is not desired. Since this template has no corresponding[ControlAction](https://developer.android.com/reference/kotlin/android/service/controls/actions/ControlAction.html#), any user interaction will launch the[Control.getAppIntent()](https://developer.android.com/reference/kotlin/android/service/controls/Control.html#getAppIntent()). <br /> | | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)                                     | [getTemplateId](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#getTemplateId())`()` <br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | ||

## Public constructors

### RangeTemplate

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

```
RangeTemplate(
    templateId: String, 
    minValue: Float, 
    maxValue: Float, 
    currentValue: Float, 
    stepValue: Float, 
    formatString: CharSequence?)
```

Construct a new[RangeTemplate](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#). The range must be valid, meaning:

- `minValue`\<`maxValue`
- `minValue`\<`currentValue`
- `currentValue`\<`maxValue`
- 0 \<`stepValue`

<br />

The current value of the Control will be formatted accordingly.

|                                                                                                                   Parameters                                                                                                                   ||
|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `templateId`   | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html):the identifier for this template object This value cannot be`null`.                                                                           |
| `minValue`     | [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html):minimum value for the input                                                                                                                     |
| `maxValue`     | [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html):maximum value for the input                                                                                                                     |
| `currentValue` | [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html):the current value of the[Control](https://developer.android.com/reference/kotlin/android/service/controls/Control.html#)containing this object. |
| `stepValue`    | [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html):minimum value of increments/decrements when interacting with this control.                                                                      |
| `formatString` | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?:a formatting string as per java.lang.String#format used to display the`currentValue`. If`null`is passed, the "%.1f" is used.    |

|                                        Exceptions                                         ||
|--------------------------------------|-----------------------------------------------------|
| `java.lang.IllegalArgumentException` | if the parameters passed do not make a valid range. |

## Public methods

### getCurrentValue

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

```
fun getCurrentValue(): Float
```

The current value for this range.  

### getFormatString

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

```
fun getFormatString(): CharSequence
```

Formatter for generating a user visible[String](https://developer.android.com/reference/kotlin/java/lang/String.html#)representing the value returned by[RangeTemplate.getCurrentValue](https://developer.android.com/reference/kotlin/android/service/controls/templates/RangeTemplate#getCurrentValue()).

|                                                                                         Return                                                                                         ||
|-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------|
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html) | a formatting string as specified in java.lang.String#format This value cannot be`null`. |

### getMaxValue

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

```
fun getMaxValue(): Float
```

The maximum value for this range.  

### getMinValue

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

```
fun getMinValue(): Float
```

The minimum value for this range.  

### getStepValue

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

```
fun getStepValue(): Float
```

The value of the smallest increment or decrement that can be performed on this range.  

### getTemplateType

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

```
fun getTemplateType(): Int
```

|                                                                                                              Return                                                                                                               ||
|----------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [ControlTemplate.TYPE_RANGE](https://developer.android.com/reference/kotlin/android/service/controls/templates/ControlTemplate#TYPE_RANGE:kotlin.Int) |